FIWARE IoT Agent-ul与IoT Agent-json启动异常问题排查求助

问题1：iotagent-ul（默认HTTP）报MQTT连接错误 #

核心排查点 #

• 检查docker-compose.yml中iotagent-ul的环境变量，是否误配置了MQTT相关参数（比如IOTA_MQTT_HOST、IOTA_MQTT_PORT），或者启用了MQTT插件（IOTA_PLUGINS=mqtt）。即使默认使用HTTP，只要存在MQTT配置项，Agent就会尝试连接MQTT broker，触发连接失败报错。
• 排查是否存在重复回调配置，比如同时设置了HTTP和MQTT的路由回调，导致Error: Callback was already called冲突。

修复操作 #

在iotagent-ul的服务配置块中，移除所有MQTT相关环境变量，示例配置：

services:
  iotagent-ul:
    image: fiware/iotagent-ul:latest
    environment:
      # 保留原有HTTP核心配置，如IOTA_HTTP_PORT、IOTA_NORTH_PORT等
      IOTA_HTTP_PORT: 4041
      IOTA_NORTH_PORT: 7896
      # 移除所有MQTT相关配置项
      # IOTA_MQTT_HOST: mqtt-broker
      # IOTA_MQTT_PORT: 1883
      # IOTA_PLUGINS: mqtt

问题2：iotagent-json（配置MQTT）报AMQP绑定错误 #

核心排查点 #

• 检查iotagent-json的环境变量，是否残留了AMQP相关配置（比如IOTA_AMQP_HOST、IOTA_AMQP_PORT），或者未明确禁用AMQP。即使设置了IOTA_DEFAULT_TRANSPORT=MQTT，只要AMQP配置存在，Agent会尝试初始化AMQP连接，引发连接拒绝错误。
• 确认是否挂载了自定义配置文件（如config.js），其中硬编码了AMQP配置，未被环境变量覆盖。

修复操作 #

在iotagent-json的服务配置块中，明确禁用AMQP并移除相关配置，示例配置：

services:
  iotagent-json:
    image: fiware/iotagent-json:latest
    environment:
      IOTA_DEFAULT_TRANSPORT: MQTT
      IOTA_MQTT_HOST: mqtt-broker
      IOTA_MQTT_PORT: 1883
      # 明确禁用AMQP
      IOTA_AMQP_ENABLED: "false"
      # 移除所有AMQP相关配置项
      # IOTA_AMQP_HOST: amqp-broker
      # IOTA_AMQP_PORT: 5672

通用验证步骤 #

1. 查看容器完整日志：执行docker logs <container-id>，确认配置加载情况，排查是否有隐藏的默认配置被启用。
2. 测试网络连通性：在iotagent容器内执行ping <broker-host>，确认与MQTT/AMQP服务的网络可达性（如果相关服务存在）。
3. 确认容器网络：确保所有Agent和依赖服务（如MQTT broker）在同一个Docker网络下，避免跨网络访问问题。

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