{"record":{"id":"134718071d3962e3","repo":"influxdata/influxdb","slug":"node-node-id-advertises-no-connection-address-conn-info-e-g","errorCode":null,"errorMessage":"node '{node_id}' advertises no connection address (conn info e.g. 8181), so other query group members cannot reach it","messagePattern":"node '(.+?)' advertises no connection address \\(conn info e\\.g\\. 8181\\), so other query group members cannot reach it","errorType":"error_code","errorClass":"CatalogError","httpStatus":null,"severity":"error","filePath":"influxdb3_catalog/src/error.rs","lineNumber":389,"sourceCode":"    #[error(\n        \"cannot remove node '{node_id}' because it is a member of query group '{query_group_name}' (id {query_group_id})\"\n    )]\n    NodeInQueryGroup {\n        node_id: Arc<str>,\n        query_group_name: Arc<str>,\n        query_group_id: QueryGroupId,\n    },\n\n    #[error(\n        \"cannot place node '{node_id}' in this query group because it already belongs to query group '{query_group_name}' (id {query_group_id})\"\n    )]\n    NodeAlreadyInQueryGroup {\n        node_id: Arc<str>,\n        query_group_name: Arc<str>,\n        query_group_id: QueryGroupId,\n    },\n\n    #[error(\n        \"node '{node_id}' advertises no connection address (conn info e.g. 8181), so other query group members cannot reach it\"\n    )]\n    QueryGroupMemberNotConnectable { node_id: Arc<str> },\n\n    #[error(\n        \"node '{node_id}' cannot clear its connection address (conn info e.g. 8181) while it is a member of query group '{query_group_name}' (id {query_group_id})\"\n    )]\n    NodeConnInfoRequiredInQueryGroup {\n        node_id: Arc<str>,\n        query_group_name: Arc<str>,\n        query_group_id: QueryGroupId,\n    },\n}\n\nimpl CatalogError {\n    pub fn invalid_configuration(message: impl AsRef<str>) -> Self {\n        Self::InvalidConfiguration {\n            message: Box::from(message.as_ref()),","sourceCodeStart":371,"sourceCodeEnd":407,"githubUrl":"https://github.com/influxdata/influxdb/blob/06200ef96ba82c5f6727e5038a83af8e722c6875/influxdb3_catalog/src/error.rs#L371-L407","documentation":"This error indicates that a node which is (or is being made) a member of a query group has no connection address advertised (no conn info such as port 8181). Query group members must be reachable by peers for distributed query coordination, so the catalog rejects group membership for unadvertised/unconnectable nodes.","triggerScenarios":"Adding a node to a query group, or validating group membership, when the node's catalog record lacks connection info (host/port) needed by other group members.","commonSituations":"Starting a node without configuring its HTTP bind/advertised address, then joining it to a query group; partial node registration where conn info was never set; containerized deployments where the advertised address env var is missing.","solutions":["Set the node's connection address (conn info, e.g. HTTP port 8181) via the catalog/node update API before joining the query group","Configure the node's advertised address/port at startup (e.g. the HTTP bind address setting) and restart the node","Remove the node from the query group if it is not intended to serve distributed queries"],"exampleFix":"// before\ncatalog.add_node_to_query_group(group_id, node_id)?; // node has no conn info\n// after\ncatalog.update_node_conn_info(node_id, \"8181\")?;\ncatalog.add_node_to_query_group(group_id, node_id)?;","handlingStrategy":"validation","validationCode":"let node = catalog.get_node(node_id)?;\nif node.conn_info().is_none() {\n    return Err(\"node has no advertised address; set conn info before joining a query group\");\n}","typeGuard":null,"tryCatchPattern":"match result {\n    Err(CatalogError::QueryGroupMemberNotConnectable { node_id }) => {\n        catalog.update_node_conn_info(node_id, \"8181\")?;\n        // retry join\n    }\n    r => r?,\n}","preventionTips":["Always configure the node's HTTP bind/advertised address at startup","Validate node connectivity (health endpoint) before joining groups in automation","Include conn-info checks in pre-join validation scripts"],"tags":["catalog","query-group","network","missing-address"],"backgroundTag":"missing-required-config-field","analyzedSha":"06200ef96ba82c5f6727e5038a83af8e722c6875","analyzedAt":"2026-09-19T12:55:30.003Z","contentChangedAt":"2026-09-19T12:55:30.003Z","schemaVersion":2},"datasetVersion":"2026-09-23T08:17:48.524Z"}