Spring Boot请求超30秒返回500 Internal Server Error，后端逻辑仍运行

核心触发原因 #

你遇到的情况大概率是服务端或中间件的连接/请求超时导致连接提前断开，但后端业务线程已启动，所以会继续执行到结束；而客户端因连接断开收到500错误。即便你没手动配置超时，Spring Boot内嵌的Tomcat或前端代理组件可能存在默认超时设置。

具体排查与解决步骤 #

• 调整内嵌Tomcat的超时配置
  Spring Boot内嵌Tomcat默认的connectionTimeout为20000ms（20秒），部分环境可能被调整为30秒。你可以在配置文件中显式设置更长的超时时间：

  # application.properties
  # 设置连接超时为60秒
  server.tomcat.connection-timeout=60000
  # 长连接场景下设置keep-alive超时
  server.tomcat.keep-alive-timeout=60000
  

  若使用YAML格式：

  # application.yml
  server:
    tomcat:
      connection-timeout: 60000
      keep-alive-timeout: 60000
  

• 配置Spring MVC请求超时
  若业务逻辑为同步执行，可通过WebMvcConfigurer设置全局请求超时；若是异步请求，也需配置异步超时：

  import org.springframework.context.annotation.Configuration;
  import org.springframework.web.servlet.config.annotation.AsyncSupportConfigurer;
  import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;
  
  @Configuration
  public class WebMvcTimeoutConfig implements WebMvcConfigurer {
      @Override
      public void configureAsyncSupport(AsyncSupportConfigurer configurer) {
          // 设置异步请求超时为60秒
          configurer.setDefaultTimeout(60000);
      }
  }
  

  另外，建议将长耗时业务改为异步处理（比如用@Async注解），避免阻塞请求线程，同时更灵活地控制超时。

• 检查前端代理/网关的超时设置
  如果你的服务前面部署了Nginx、API网关等中间件，这些组件通常会有自己的超时配置（比如Nginx的proxy_read_timeout）。需要确认这些组件的超时时间是否大于你的业务逻辑执行时长，若不足则调整对应配置。

• 验证响应发送状态
  在控制器返回语句前后添加日志，同时查看服务端日志是否有Broken pipe或Connection reset by peer这类错误。这类日志说明连接在响应发送前已断开，此时要么延长超时时间，要么优化业务逻辑缩短执行耗时。

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