解决 action-gh-release 项目中的 422 未定义错误

在使用 action-gh-release 项目创建 GitHub 发布时，开发者可能会遇到一个常见的 HTTP 422 错误，错误信息显示为"undefined"。这个问题通常与 release.yml 文件的格式问题有关。

问题现象

当开发者配置了 generate_release_notes 参数为 true 时，action-gh-release 会尝试读取项目根目录下的 .github/release.yml 文件来生成发布说明。如果这个 YAML 文件存在格式问题，就会导致 GitHub API 返回 422 错误。

典型的错误日志会显示：

⚠️ GitHub release failed with status: 422 undefined

根本原因

422 错误是 HTTP 状态码中的"不可处理的实体"错误，表示服务器理解请求实体的内容类型，但无法处理包含的指令。在这个场景下，通常是由于：

1. release.yml 文件存在语法错误
2. YAML 文件缩进不正确
3. 文件内容不符合 GitHub 的预期格式

解决方案

要解决这个问题，开发者需要仔细检查 .github/release.yml 文件的格式。以下是一些关键检查点：

1. 确保正确的缩进：YAML 对缩进非常敏感，必须使用空格而非制表符
2. 验证文件结构：确认文件遵循 GitHub 要求的格式规范
3. 使用 YAML 验证工具：可以使用在线 YAML 验证器检查文件语法

实际案例

有开发者报告，即使 action 执行失败并显示 422 错误，GitHub 发布仍然成功创建。这表明问题可能仅出现在生成发布说明的阶段，而不影响核心发布功能。

最佳实践

1. 在本地使用 YAML 验证工具检查 release.yml 文件
2. 在 IDE 中启用 YAML 插件，获得实时语法检查
3. 逐步增加 release.yml 的复杂度，确保每一步都能正常工作
4. 考虑先在本地测试发布说明生成，再集成到 CI/CD 流程中

通过遵循这些实践，开发者可以有效避免 422 错误，确保 action-gh-release 能够顺利生成发布说明并创建 GitHub 发布。