Tomcat关闭时Acceptor线程未干净停止的问题排查求助

类似问题与解决方法 #

这个问题在使用Tomcat NIO连接器的场景下并不少见，尤其是macOS环境中。你可以尝试以下几种解决方案：

• 给Tomcat停止命令添加超时与强制参数：执行 catalina.sh stop 5 -force，指定5秒超时后强制终止未退出的线程，避免等待系统默认的长超时
• 调整Connector的停止超时配置：在conf/server.xml的HTTP Connector节点中添加stopTimeout="2000"（单位毫秒），让Tomcat在停止时给Acceptor线程更合理的退出等待时间，示例配置：

  <Connector port="8080" protocol="HTTP/1.1"
             connectionTimeout="20000"
             redirectPort="8443"
             stopTimeout="2000"/>
  

• 限制长连接数量：如果你的服务启用了长连接，在Connector中设置maxKeepAliveRequests="100"，避免大量未关闭的长连接占用资源，导致Acceptor线程无法干净退出

Acceptor线程的具体运行位置 #

Tomcat的HTTP NIO连接器的Acceptor线程是org.apache.tomcat.util.net.NioEndpoint类的内部类Acceptor，它的核心逻辑是循环调用serverSocketChannel.accept()监听端口，获取新的客户端连接，直到收到Tomcat的停止信号（通过设置running标志为false）。

线程相关问题排查指引 #

• 查看线程实时状态：在执行catalina.sh stop前，先用jps命令找到Tomcat的进程ID，再执行jstack <PID>，搜索http-nio-8080-Acceptor线程，查看它的栈帧信息——如果线程卡在sun.nio.ch.ServerSocketChannelImpl.accept()调用上，说明是阻塞式的accept未被及时中断，需要调整超时配置
• 检查日志细节：查看logs/catalina.out日志，在停止Tomcat的时间段内，排查是否有其他线程（如业务线程、连接处理线程）阻塞，导致Tomcat无法正常触发Acceptor线程的退出逻辑
• 验证连接器配置：确认server.xml中Connector的protocol是否为org.apache.coyote.http11.Http11NioProtocol（NIO模式），如果切换到BIO模式（HTTP/1.1）测试是否还会出现该问题，以此确认是否为NIO连接器的特定问题
• 排查系统层面限制：在macOS下，检查系统的端口回收机制，执行sysctl net.inet.tcp.msl查看TCP连接的TIME_WAIT超时时间，若该值过大，也可能导致重启时端口占用检测耗时增加

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