Jira创建Issue时customfield_12305字段报错的额外排查求助

先贴出报错信息：

response text = {"errorMessages":[],"errors":{"customfield_12305":"Field 'customfield_12305' cannot be set. It is not on the appropriate screen, or unknown."}}

以下是除了屏幕配置之外，可能导致问题的原因和排查步骤：

1. 字段上下文未覆盖当前项目/问题类型 #

进入「设置 > 问题 > 自定义字段」找到目标字段，点击「配置」查看上下文。如果字段仅对特定项目或Issue类型开放权限，而你要创建的Issue不在范围内，就会触发报错。需确保上下文包含你的目标项目和对应的Issue类型。

2. 账号缺少该字段的编辑权限 #

在自定义字段配置页切换到「权限」选项卡，检查你的用户组或个人账号是否拥有该字段的编辑权限。同时也要查看项目的权限方案，确认没有单独限制该字段的编辑权限。

3. 传入值的类型与字段不匹配 #

比如字段是单选选择列表，你却传入了多选值；或是日期字段，传入的字符串格式不符合Jira要求（如未使用yyyy-MM-dd格式）。核对字段的实际类型，确保传入值的格式、类型完全匹配。

4. 屏幕方案与操作的关联错误 #

虽然字段在创建屏幕上，但项目的屏幕方案可能未将该屏幕与「创建Issue」操作绑定。进入「设置 > 问题 > 屏幕方案」，找到项目对应的方案，检查「创建Issue」操作是否绑定了包含该字段的屏幕，避免因多屏幕方案混淆导致的问题。

5. 字段处于禁用状态 #

在自定义字段列表中查看该字段是否为禁用状态，禁用的字段即便在屏幕上也无法设置，改为启用状态后再测试。

6. API调用的字段ID错误 #

字段ID可能因重复创建或系统变更发生变化，进入自定义字段配置页，查看浏览器地址栏中的customFieldId参数，确认与你API调用时使用的customfield_12305一致，避免用错ID。

7. 工作流初始状态限制字段编辑 #

部分字段仅在特定工作流状态下允许编辑，而创建Issue的初始状态可能被设置为不可编辑该字段。进入项目工作流配置，检查初始状态的字段权限，确保创建时（初始状态）该字段处于可编辑状态。

8. 第三方插件冲突 #

如果安装了脚本runner、自定义字段类等第三方插件，可能存在插件冲突导致字段无法正常设置。可临时禁用相关插件，再测试是否能正常设置字段，排查是否为插件影响。

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