Redmine4.2.4调用API创建issue返回422 传参仍提示必填字段为空

问题复现信息 #

在自有v4.2.4.stable版本Redmine实例上调用创建Issue接口时，服务端返回422状态码。
请求配置与载荷：

POST /issues.json
Content-Type: application/json
X-Redmine-API-Key: xxxx

{
  "issue": {
    "subject": "Subject VF",
    "project_id": 444,
    "tracker_id": 7,
    "status_id": 10,
    "description": "Desc VF"
  }
}

接口返回错误：

{
    "errors": [
        "Project cannot be blank",
        "Tracker cannot be blank",
        "Status cannot be blank"
    ]
}

已确认的前置信息：

• 省略subject字段发起请求时，接口会额外返回Subject cannot be blank错误，说明subject字段可被服务端正常识别
• API密钥所属账号拥有ID为444的项目的访问权限
• 传入的tracker_id=7、status_id=10均为系统内真实存在的有效值

根因与排查方案 #

该报错是Redmine 4.2.x版本接口的典型问题，按以下优先级排查即可解决：

• 第一优先级：校验字段类型
  抓包确认实际发出的请求载荷中，project_id、tracker_id、status_id三个字段的值为整数类型，没有被引号包裹成字符串。Redmine 4.2.x的参数校验逻辑不会对这几个外键字段做自动类型转换，传入字符串格式的数字会直接判定为空值。
  该问题的表现和当前现象完全一致：字符串类型的subject、description可以被正常识别，所有整数类型的ID字段全部识别失败。部分HTTP客户端、低版本序列化工具会默认将所有JSON值转为字符串，哪怕代码中定义的是数字类型，实际发包时也会变成带引号的字符串，需要重点核对。
• 第二优先级：校验项目与跟踪标签的关联配置
  进入Redmine后台，打开ID为444的项目的设置页，在问题跟踪配置项中确认ID为7的跟踪标签（Tracker）已被勾选启用。如果跟踪标签未分配给目标项目，接口不会返回「跟踪标签无效」类的明确提示，会直接将该字段置空触发空值校验。
• 第三优先级：校验工作流权限
  确认API密钥所属账号的角色，在目标项目+对应跟踪标签的工作流配置中，有权限将工单设置为ID为10的状态。如果工作流未给该角色开放对应状态的操作权限，接口不会返回权限不足类报错，会直接将状态字段置空触发空值校验。
• 第四优先级：清理请求异常字符与补全请求头
  检查原始请求体开头是否存在UTF-8 BOM头、多余空行或不可见控制字符，这类字符会干扰JSON解析逻辑导致部分字段识别失败；同时将请求头的Content-Type修改为application/json; charset=utf-8，避免服务端用默认编码解析请求时出现识别偏差。

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