Jira search_issues报错“项目未识别”问题排查求助

1. 确认项目的正确Key（不是名称） #

Jira的JQL搜索中，project字段匹配的是项目的内部Key，而非显示名称或简称，很多时候用户混淆这两者导致报错。

可以先通过代码获取账号有权限访问的所有项目，查看对应的Key：

from jira import JIRA

# 先替换为正确的认证信息（见下文修正方案）
jira = JIRA(server="https://preqin.atlassian.net", basic_auth=("你的Jira登录邮箱", "你的API Token"))

projects = jira.projects()
for proj in projects:
    print(f"项目Key: {proj.key}, 项目名称: {proj.name}")

拿到正确的Key后，修改搜索语句为：

issues = jira.search_issues('project = 你的项目Key')

若Key包含空格或特殊字符，再用双引号包裹。

2. 检查账号的项目访问权限 #

即使认证成功，你的账号可能没有目标项目的浏览权限，这会导致Jira返回“项目未被识别”的错误。直接用该账号登录Jira网页，确认能正常访问目标项目的问题列表。

3. 修正认证方式（Atlassian Cloud场景） #

你的代码中使用了OAuth配置，但Atlassian Cloud官方推荐用基本认证搭配API Token，OAuth需要额外的应用配置，容易出错。替换认证部分的代码：

from jira import JIRA

jira_server = "https://preqin.atlassian.net"
email = "你的Jira登录邮箱"
api_token = "你的API Token"

# 正确的基本认证方式
jira = JIRA(server=jira_server, basic_auth=(email, api_token))

# 执行搜索
issues = jira.search_issues('project = 你的项目Key')
print(issues)

4. 简化JQL语法 #

去掉不必要的引号（除非项目Key有特殊字符），比如project = ABC比project = "ABC"更稳妥，避免语法解析问题。

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