深入解析softprops/action-gh-release中的文件上传失败问题

GitHub Actions作为持续集成和持续部署(CI/CD)的重要工具，其生态系统中存在着大量优秀的第三方Action。softprops/action-gh-release便是其中广受欢迎的一个，它能够帮助开发者自动化地创建GitHub发布版本并上传相关文件。然而，近期该Action在v2.3.0版本中出现了一个严重的文件上传失败问题，影响了众多用户的工作流程。

问题现象

在2025年6月10日左右，大量用户报告在使用softprops/action-gh-release时遇到了相同的错误。错误表现为在尝试上传文件到GitHub Release时，Node.js运行时抛出了一个断言失败错误。错误信息明确指出问题发生在文件句柄关闭时，断言检查!closed_失败，表明文件已经被关闭的情况下又尝试关闭它。

错误日志显示这是一个Node.js核心模块中的问题，具体发生在node_file.cc文件的第457行。从堆栈跟踪可以看出，问题起源于Action内部的upload函数，当它尝试关闭文件句柄时触发了这个错误。

技术分析

这个问题本质上是一个文件句柄管理问题。在Node.js的文件系统模块中，当尝试对一个已经关闭的文件句柄执行操作时，会触发断言失败。这种情况通常发生在：

1. 文件句柄被多次关闭
2. 文件操作过程中发生了未处理的错误
3. 异步操作的回调时序出现问题

从错误发生的上下文来看，这个问题很可能与Node.js 20版本的运行时环境变化有关。GitHub Actions在2025年6月更新了其运行环境，使用了新版本的Node.js 20作为默认运行时。这种环境变化可能导致某些文件操作的异步行为发生了变化，进而触发了这个错误。

影响范围

这个问题影响了使用以下配置的用户：

• 直接使用softprops/action-gh-release@master或softprops/action-gh-release@v2的用户
• 在Ubuntu 24.04.2等新版本GitHub Actions运行环境中执行工作流的用户
• 需要上传多个文件的发布流程

值得注意的是，使用旧版本如v1或特定提交(如37fd9d0)的用户不受此问题影响，这表明这是一个新引入的回归问题。

解决方案

项目维护者已经迅速响应并发布了修复版本v2.3.1。对于遇到此问题的用户，可以采取以下解决方案：

1. 立即升级到v2.3.1或更高版本
2. 临时回退到已知可用的版本，如v2.2.2
3. 对于需要长期稳定的工作流，可以锁定到特定的提交哈希

最佳实践建议

为了避免类似问题影响您的CI/CD流程，建议采取以下预防措施：

1. 避免在生产工作流中使用@master或@v2这样的浮动标签，而是使用具体的版本号或提交哈希
2. 在升级Action版本前，先在测试分支或环境中验证新版本的行为
3. 考虑实现工作流的回退机制，当主要Action失败时可以自动尝试备用方案
4. 定期检查使用的第三方Action是否有更新或已知问题

总结

softprops/action-gh-release的文件上传问题展示了在CI/CD流程中依赖第三方组件可能带来的风险。通过理解问题的技术本质、影响范围和解决方案，开发者可以更好地管理自己的自动化流程。这次事件也提醒我们，在软件交付链中保持对依赖项的可见性和控制是多么重要。

对于使用GitHub Actions进行软件发布的团队，建议建立完善的依赖管理策略，包括版本锁定、变更监控和快速响应机制，以确保发布流程的稳定性和可靠性。