为何Python JIRA API读取.env环境变量时遇权限/超时问题？

硬编码JIRA参数时Python代码运行正常，示例代码如下：

jql_string = 'project = xyz AND assignee in (larry, curly, moe) ORDER BY key DESC'
fields = "Key, Summary, Assignee, Created, Updated)"

# 实例化Jira实例
jira = JIRA(server="https://myserver.mycompany.com/", 
            token_auth="abcd1234") # JIRA个人访问令牌

# 将问题写入字典
issueList = []
for issues in jira.search_issues(jql_str=jql_string,fields=fields,startAt=0, maxResults=False):
   
   issue = jira.issue(issues.key)   
   
   issueList.append(
       {'Issue Type'      : issue.fields.issuetype,
        'Issue key'       : issue.key,
        'Issue id'        : issue.id,
        'Summary'         : issue.fields.summary,
        'Assignee'        : issue.fields.assignee,
        'Updated'         : issue.fields.updated,
        'Severity'        : issue.fields.customfield_12825
       }
   )

# 写入数据框
# .....

但改用从.env文件导入参数后，出现权限验证失败和超时问题，导入代码如下：

import os
from dotenv import load_dotenv

load_dotenv() # 加载.env文件
jql_string = os.environ.get('JQL_STRING')
token = os.environ.get('JIRA_USER_TOKEN')
server = os.environ.get('JIRA_SERVER')

# 后续按之前逻辑实例化JIRA并查询

调试确认环境变量已正确导入，但即使仅替换server为环境变量（token和jql_string保持硬编码），仍会出现JIRA超时。

以下是针对性的排查步骤和解决方法：

1. 检查server环境变量格式 #

• 确认.env中的JIRA_SERVER值无多余空格、引号或换行符，正确格式应为：

  JIRA_SERVER=https://myserver.mycompany.com/
  

• 保持与硬编码时的结尾斜杠一致，避免拼接出错误URL导致请求失败。

2. 验证环境变量加载逻辑 #

• 确保load_dotenv()在读取环境变量之前执行，若.env文件不在代码同目录，需指定路径：load_dotenv(dotenv_path='/path/to/your/.env')。
• 读取后打印变量的原始格式，确认与硬编码值完全一致：

  print("Server:", repr(server)) # 用repr查看隐藏字符
  print("Token:", repr(token))
  print("JQL:", repr(jql_string))
  

3. 修正JQL字符串解析问题 #

• .env中的JQL不要加引号，否则引号会被当作字符串的一部分，导致JQL语法错误。正确写法：

  JQL_STRING=project = xyz AND assignee in (larry, curly, moe) ORDER BY key DESC
  

4. 确认JIRA实例初始化参数 #

• 确保实例化时参数名正确，token_auth是官方jira库的正确参数：

  jira = JIRA(server=server, token_auth=token)
  

  不要误写为auth=token，否则会触发验证失败。

5. 排查超时问题的网络原因 #

• 若仅替换server就超时，测试代码所在机器对目标server的网络可达性：

  curl -I https://your-server-from-env.com/
  

• 若存在代理，需在实例化JIRA时显式配置：

  jira = JIRA(server=server, token_auth=token, options={'proxy': 'http://your-proxy:port'})
  

6. 验证token的跨实例权限 #

• 若环境变量中的server对应不同的JIRA实例（如测试/生产环境），需确认token在目标实例中有效，可通过API直接测试：

  curl -H "Authorization: Bearer your-token" https://your-server-from-env.com/rest/api/2/myself
  

  返回401则说明token在该server上无权限。

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