WSO2 API Manager发布服务反复报404，求助排查CP与GW的JMS连接

一、检查CP与GW的JMS连接状态 #

• 登录CP的Carbon控制台（https://<CP_HOST>:9443/carbon），进入Message Broker -> Queues，查看默认API同步队列amq.topic的状态：确认队列是否有消息堆积、当前连接数是否正常，若队列无活跃连接或消息堆积过多，说明JMS连接存在异常。
• 用JVM监控工具（jconsole/jvisualvm）连接GW节点的JVM，查看JMS客户端的连接、会话状态：检查是否存在断开未释放的连接，或会话创建失败的情况。
• 核对GW的deployment.toml中JMS同步配置：

  [[apim.gateway.sync.jms]]
  connection_factory_name = "TopicConnectionFactory"
  topic_name = "amq.topic"
  username = "${admin.username}"
  password = "${admin.password}"
  parameter.initial_naming_factory = "org.wso2.andes.jndi.PropertiesFileInitialContextFactory"
  parameter.provider_url = "tcp://<CP_HOST>:5672"
  

  确保provider_url指向正确的CP Broker地址，AMQP端口（默认5672）未被防火墙拦截，账号密码配置正确。

二、相关日志位置及分析 #

• CP端日志：
  • <CP_HOME>/repository/logs/carbon.log：搜索JMS、Broker、TopicConnectionFactory关键词，排查是否有连接超时、认证失败、队列满的错误日志。
  • <CP_HOME>/repository/logs/audit.log：查看API发布/同步的审计记录，确认API元数据是否成功发送到GW队列。
• GW端日志：
  • <GW_HOME>/repository/logs/carbon.log：查找JMS Consumer、API sync相关内容，检查是否存在无法接收CP事件、连接断开后重连失败的信息。
  • <GW_HOME>/repository/logs/gateway-worker.log：查看API路由加载日志，确认是否有API元数据未同步到GW的记录。
• 外部Broker日志（若使用第三方Broker如ActiveMQ）：查看Broker自带的日志文件（如activemq.log），排查连接断开、会话异常、队列阻塞等问题。

三、解决方案 #

1. 优化JMS连接池与重连配置 #

在GW的deployment.toml中添加/调整连接池参数，提升连接稳定性：

[[apim.gateway.sync.jms]]
# 保留原有基础配置
parameter.connection_pool.max_active = 50
parameter.connection_pool.max_idle = 10
parameter.connection_pool.min_idle = 5
parameter.connection_pool.idle_timeout = 30000
parameter.connection_pool.validate_on_borrow = true
# 启用自动重连
parameter.failover = "true"
parameter.failover_max_retries = "10"
parameter.failover_retry_interval = "5000"

2. 强制同步API元数据 #

• 登录CP的Publisher，找到异常API，点击Deploy to Gateway，重新选择目标GW部署；
• 用WSO2 CLI命令强制同步：

  apictl deploy-api -f <你的API压缩包路径> -e <环境名称> -k
  

3. 排查网络连通性 #

• 用telnet <CP_HOST> 5672或nc -zv <CP_HOST> 5672测试CP与GW间的AMQP端口连通性；
• 检查防火墙/安全组规则，确保CP的5672（AMQP）、9443（Carbon）端口允许GW访问。

4. 版本升级与补丁应用 #

若当前WSO2版本存在JMS连接池泄漏等已知Bug，升级到最新稳定版本，或应用官方发布的对应补丁。

5. 配置实时监控 #

• 启用WSO2 Observability监控面板，实时监控JMS连接数、队列长度、消息处理速率；
• 设置告警规则，当JMS连接数为0或队列消息堆积超过阈值时触发告警，提前干预。

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