执行npx semantic-release后GitLab流水线提交阶段卡顿失败求助

从日志能看到几个关键异常点：

• analyzeCommits步骤（下午2:38）到prepare步骤（晚上10:11）间隔7小时以上，明显卡在commit分析阶段
• prepare步骤执行后10小时才失败，说明git提交操作出现长时间卡顿，最终超时

虽然你没做代码变更，但这类突发卡顿通常和环境资源、依赖隐性更新、外部服务限制有关。

• 检查GitLab Runner资源状态
  流水线卡顿大概率是Runner的CPU、内存不足导致的。去GitLab的Runner管理页面查看对应Runner的监控数据，确认是否有资源耗尽情况。如果是共享Runner，可切换到专属Runner或临时增加Runner资源配置测试。

• 清理semantic-release缓存
  缓存堆积可能引发异常行为。在流水线执行npx semantic-release前，添加清理缓存命令：

  rm -rf node_modules/.cache/semantic-release
  

  也可以在GitLab CI配置里禁用semantic-release的缓存，验证是否恢复正常。

• 限制commit分析范围
  若分支合并后引入大量历史commit，会导致analyzeCommits步骤耗时过长。临时设置环境变量限制分析范围，比如只分析最近10个commit：

  export SEMANTIC_RELEASE_COMMIT_RANGE=$(git rev-parse HEAD~10)..HEAD
  npx semantic-release
  

  如果这样能快速完成，说明是commit数量过多导致的卡顿，可调整semantic-release的analyzeCommits配置，忽略无关历史commit。

• 锁定插件版本
  即使你没手动更新依赖，npm可能自动拉取了@semantic-release/git或其他插件的小版本更新，新版本可能存在隐性bug。在package.json里固定相关插件版本：

  "devDependencies": {
    "@semantic-release/git": "X.X.X",
    "@semantic-release/gitlab": "X.X.X"
  }
  

  替换成当前能正常运行的版本号，重新安装依赖后测试。

• 检查GitLab API限制
  semantic-release与GitLab交互时可能触发API速率限制，导致请求卡住超时。去GitLab项目设置里查看API请求日志，确认是否有被限流的记录。如果是，可在semantic-release配置里添加重试参数：

  // .releaserc.js
  module.exports = {
    plugins: [
      ["@semantic-release/gitlab", {
        retry: { retries: 3 }
      }]
    ]
  }
  

• 检查待提交文件
  日志显示有2个文件要提交，检查这两个文件是否为大文件、二进制文件或有特殊权限。这类文件可能导致git commit操作卡住。尝试在本地手动提交这两个文件，确认是否能正常完成，排除文件本身的问题。

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