WSO2 APIM 2.1.0分布式部署KeyManager启动遇连接拒绝错误

我之前部署WSO2 APIM 2.1.0分布式环境时也碰到过一模一样的问题，结合踩过的坑，给你几个针对性的排查方向：

1. 先确认数据库连接是否正常 #

KeyManager依赖共享的APIM_DB、REG_DB等数据库，这是最容易出问题的点：

• 先检查数据库服务（MySQL/PostgreSQL等）是否正常运行，监听的端口有没有开放
• 打开KeyManager的repository/conf/datasources/master-datasources.xml，核对里面的数据库URL、端口、用户名密码，特别是IP地址有没有改成分布式环境中数据库的实际地址，别写错了
• 直接从KeyManager所在机器用数据库客户端测试连接，比如Linux上跑mysql -h <数据库IP> -P <端口> -u <用户名> -p，能连上的话数据库这块就没问题

2. 验证Traffic Manager的Thrift端点连通性 #

分布式部署里KeyManager要和Traffic Manager通信，大概率是这个端点出问题：

• 打开KeyManager的repository/conf/api-manager.xml，找到<TrafficManager>节点，确认<URL>里的IP和端口是Traffic Manager的实际Thrift端口（默认7711），比如tcp://<TM机器IP>:7711
• 先确认Traffic Manager已经正常启动，在TM机器上用netstat -anp | grep 7711（Linux）或者netstat -ano | findstr 7711（Windows）检查端口是否在监听
• 从KeyManager机器上用telnet或者nc命令测连通性，比如telnet <TM_IP> 7711，如果不通，十有八九是防火墙或者安全组把7711端口拦住了，得放开这个端口

3. 排查Metrics数据发布的端点配置 #

DataEndpointConnectionWorker也负责Metrics数据的上报，这块配置错了也会报连接拒绝：

• 检查KeyManager的repository/conf/dashboard/dashboard.xml，确认<BAMServerURL>指向的是正确的Analytics服务端点
• 如果启用了Data Publisher，打开repository/conf/data-bridge/data-bridge.properties，核对data.publisher.url的配置，对应的服务要正常启动且端口开放

4. 检查端口占用或冲突 #

如果多个APIM实例在同一机器，端口偏移没设对的话会导致冲突：

• 查看KeyManager的repository/conf/carbon.xml，确认<Offset>值和其他组件（比如Gateway、Publisher）不一样，避免端口重叠
• 用netstat -anp（Linux）查看端口占用，确保KeyManager需要的端口没被其他进程抢走

5. 看完整日志定位具体失败的端点 #

错误提示只说连接被拒绝，但没说具体是哪个端点，建议去KeyManager的repository/logs/wso2carbon.log里找完整的错误信息，里面会显示具体要连接的IP和端口，这样能直接锁定问题所在，比如如果日志里显示是连接tcp://192.168.1.50:7711失败，那直接去查Traffic Manager的状态就行

内容的提问来源于stack exchange，提问作者DushaniW