apache/hadoop · error · IllegalArgumentException

Invalid router entry, no address specified {}

Error message

Invalid router entry, no address specified {}

What it means

Error "Invalid router entry, no address specified {}" thrown in apache/hadoop.

Source

Thrown at hadoop-hdfs-project/hadoop-hdfs-rbf/src/main/java/org/apache/hadoop/hdfs/server/federation/store/records/RouterState.java:141

  @Override
  public String toString() {
    return getAddress() + " -> " + getStatus() + "," + getVersion();
  }

  @Override
  public SortedMap<String, String> getPrimaryKeys() {
    SortedMap<String, String> map = new TreeMap<>();
    map.put("address", getAddress());
    return map;
  }

  @Override
  public void validate() {
    super.validate();
    if ((getAddress() == null || getAddress().length() == 0) &&
        getStatus() != RouterServiceState.INITIALIZING) {
      throw new IllegalArgumentException(
          "Invalid router entry, no address specified " + this);
    }
  }

  @Override
  public int compareTo(BaseRecord other) {
    if (other == null) {
      return -1;
    } else if (other instanceof RouterState) {
      RouterState router = (RouterState) other;
      return this.getAddress().compareTo(router.getAddress());
    } else {
      return super.compareTo(other);
    }
  }

  @Override
  public boolean checkExpired(long currentTime) {

View on GitHub (pinned to 2add963021)

Solutions

1. Ensure the Router registration includes its RPC/web address before being stored.
2. Check Router startup logs for address binding failures that left the address unset.

When it happens

Trigger: RouterState record validation: the router address field is null or empty.

Common situations: Corrupted router registration in the State Store or a Router that registered before resolving its address.

AI-assisted analysis of apache/hadoop@2add963021 (2026-08-22). Data as JSON: /api/errors/7c06a294c23c8a0d. Report an issue: GitHub.