alibaba/nacos · error · NacosApiException

400

400

Error message

Required parameter 'ip' type String is not present

What it means

Error "Required parameter 'ip' type String is not present" thrown in alibaba/nacos.

Source

Thrown at api/src/main/java/com/alibaba/nacos/api/naming/pojo/Instance.java:195

    }
    
    public void setEnabled(final boolean enabled) {
        this.enabled = enabled;
    }
    
    public boolean isEphemeral() {
        return this.ephemeral;
    }
    
    public void setEphemeral(final boolean ephemeral) {
        this.ephemeral = ephemeral;
    }
    
    @Override
    public void validate() throws NacosApiException {
        fillDefaultValue();
        if (StringUtils.isBlank(ip)) {
            throw new NacosApiException(NacosException.INVALID_PARAM, ErrorCode.PARAMETER_MISSING,
                "Required parameter 'ip' type String is not present");
        }
        if (port < 0 || port > MAX_PORT) {
            throw new NacosApiException(NacosException.INVALID_PARAM,
                ErrorCode.PARAMETER_VALIDATE_ERROR,
                "Required parameter 'port' type int is require 0 ~ 65535");
        }
    }
    
    private void fillDefaultValue() {
        if (StringUtils.isBlank(clusterName)) {
            clusterName = Constants.DEFAULT_CLUSTER_NAME;
        }
    }
    
    @Override
    public String toString() {
        return "Instance{" + "instanceId='" + instanceId + '\'' + ", ip='" + ip + '\'' + ", port="

View on GitHub (pinned to 9b989acdf1)

Solutions

1. Include the required parameter in the request and retry.

When it happens

Trigger: Thrown at api/src/main/java/com/alibaba/nacos/api/naming/pojo/Instance.java:195 when the library encounters an invalid state.

Common situations: Building an Instance without the required ip parameter.

AI-assisted analysis of alibaba/nacos@9b989acdf1 (2026-08-14). Data as JSON: /api/errors/7b8a0394514c1d43. Report an issue: GitHub.