Error message
RPCProtocolTemplateComponent invalid address.Cause
The HSF framework generates this error when it cannot establish a TCP connection to the target service address. This is a framework-level error, not an application logic error.
Common root causes:
The remote service is down or has not started.
The IP address or port registered in the service registry is incorrect or stale.
A security group rule or firewall blocks the connection.
The provider and consumer are in different VPCs without proper network connectivity.
Troubleshooting steps
Work through the following checks in order. Stop when you find the issue.
1. Verify that the provider is running
Confirm that the service provider instance is healthy and has registered with the HSF registry. Check the provider application logs for startup errors.
2. Check the registered address
Look up the provider address in the EDAS console or the HSF registry. Verify that the IP and port match the actual provider endpoint.
3. Test network connectivity
From the consumer instance, test the connection to the provider address and port:
telnet <provider-ip> <provider-port>| Placeholder | Description | Example |
|---|---|---|
<provider-ip> | IP address of the provider instance | 192.168.0.10 |
<provider-port> | Port the provider listens on | 12200 |
If the connection times out or is refused, proceed to the next step.
4. Check security group and firewall rules
If both instances are in the same VPC, verify that the security group attached to the provider allows inbound traffic on the service port.
If the instances are in different VPCs or regions, verify that the networks are connected through VPC peering, a Cloud Enterprise Network (CEN) instance, or a VPN connection, and that the routing and security group rules allow traffic between the two endpoints.
5. Check for stale registrations
If the provider was recently restarted or migrated, the registry may still hold the old address. Wait for the registration to refresh, or manually re-register the provider in the EDAS console.