Ejabberd 18配置报错：ejabberd_c2s的timeout选项无效致连接异常

我之前维护Ejabberd 18版本时碰到过完全一样的问题，咱们一步步拆解解决：

为什么会出现"unknown listen option 'timeout' for 'ejabberd_c2s'"？ #

Ejabberd 18版本对ejabberd_c2s的监听配置做了参数调整——原来的timeout选项被移除了，换成了更明确的idle_timeout参数来控制客户端空闲连接的超时时间。直接沿用旧版本的timeout参数自然会触发这个错误日志。

修复步骤 #

1. 移除无效的timeout参数 #

打开你的ejabberd配置文件（通常是ejabberd.yml），找到listen块下的ejabberd_c2s配置，删掉里面的timeout: xxx这一行。

2. 配置正确的超时参数 #

替换成Ejabberd 18支持的idle_timeout，同时可以根据需求添加TCP层面的超时和保活配置，示例如下：

listen:
  - port: 5222
    module: ejabberd_c2s
    idle_timeout: 3600  # 客户端空闲1小时后断开连接，单位秒，可按需调整
    tcp_timeout: 60     # TCP连接层面的超时时间，可选配置
    tcp_keepalive: true # 开启TCP保活，帮助维持长连接，可选配置
    # 保留你原有的其他配置（比如tls、认证相关）

3. 验证客户端连接问题 #

修改配置后，重启ejabberd服务：

ejabberdctl restart

之后测试客户端连接，应该不会再出现立即断开的情况。如果问题依旧，可以检查：

• 客户端是否正确匹配服务器配置（比如服务器开启TLS时，客户端是否也启用了对应设置）
• 服务器防火墙是否放行5222端口（或你自定义的c2s端口）
• ejabberd日志中是否有其他报错信息（比如认证失败、资源配额限制等）

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