如何调整Jira的Socket超时值？现有方案无法满足2分钟需求

问题分析 #

你遇到的核心问题是：Jira部分REST API响应过慢触发Request Time Out Error，尝试修改General Configuration和JVM参数后未达预期——设置20秒超时符合预期，但设置2-14分钟时，超过50秒的请求仍报错。这说明存在其他层级的超时限制覆盖了你的JVM配置，大概率是Tomcat容器或前端代理的超时设置。

有效调整方案 #

1. 修改Tomcat连接超时（Jira内置容器）

Jira基于Tomcat运行，Tomcat的connectionTimeout和asyncTimeout参数会直接控制HTTP连接的超时时间，优先级高于JVM参数：

• 找到Jira安装目录下的conf/server.xml文件
• 定位到<Connector>节点，添加/修改以下属性：

  <Connector port="8080" 
             connectionTimeout="120000" 
             asyncTimeout="120000"
             <!-- 保留原有其他属性 -->
             />
  

  其中120000代表2分钟（单位：毫秒）
• 保存文件后重启Jira服务

2. 检查前端代理/负载均衡的超时设置

如果Jira前端部署了Nginx、Apache等代理服务，这些服务的超时设置会提前断开连接，导致Jira的设置无效：

• Nginx：修改配置文件中的proxy_read_timeout和proxy_connect_timeout为120秒以上：

  proxy_connect_timeout 120s;
  proxy_read_timeout 120s;
  

• Apache：调整ProxyTimeout参数为120：

  ProxyTimeout 120
  

• 修改后重启代理服务

3. 调整Jira内部REST客户端超时

如果是Jira自身调用外部REST API出现超时，需要修改jira-config.properties文件：

• 找到Jira数据目录下的jira-config.properties（如果不存在则新建）
• 添加以下配置：

  http.socket.timeout=120000
  http.connection.timeout=120000
  

• 保存后重启Jira

验证方法 #

测试一个预期响应时间超过50秒的REST API请求（比如批量创建项目、大规模数据查询），确认请求能正常完成且不再触发超时错误。

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