alibaba/nacos · error · NacosRuntimeException
SERVER_ERROR
SERVER_ERROR
Error message
No healthy server node found.
What it means
Error "No healthy server node found." thrown in alibaba/nacos.
Source
Thrown at console/src/main/java/com/alibaba/nacos/console/handler/impl/remote/RemoteServerConnector.java:97
*/
public String getServerContextPath() {
return EnvUtil.getProperty("nacos.console.remote.server.context-path", "/nacos");
}
/**
* Randomly select one healthy member from the cluster.
*
* @return a healthy cluster member
* @throws NacosException if no healthy server node is found
*/
public Member randomOneHealthyMember() throws NacosException {
Collection<Member> allMembers = memberManager.allMembers();
Collection<? extends NacosMember> membersWithState = remoteClusterHandler.getNodeList("");
Map<String, NodeState> nodeStateMap = membersWithState.stream()
.collect(Collectors.toMap(NacosMember::getAddress, NacosMember::getState));
allMembers.removeIf(node -> !NodeState.UP.equals(nodeStateMap.get(node.getAddress())));
if (CollectionUtils.isEmpty(allMembers)) {
throw new NacosRuntimeException(NacosException.SERVER_ERROR,
"No healthy server node found.");
}
return allMembers.parallelStream().findAny().orElseThrow();
}
}
View on GitHub (pinned to 9b989acdf1)
Solutions
- Review the input and runtime state for no healthy server node, correct the reported problem, and retry.
When it happens
Trigger: Thrown at console/src/main/java/com/alibaba/nacos/console/handler/impl/remote/RemoteServerConnector.java:97 when the library encounters an invalid state.
Common situations: Remote console mode found no healthy upstream server node.
AI-assisted analysis of alibaba/nacos@9b989acdf1 (2026-08-14).
Data as JSON: /api/errors/a3a3460ee854f000.
Report an issue: GitHub.