Github Action发布NPM包遇EPrivate错误求助

可能原因 #

• package.json不一致：GitHub Action运行环境拉取的代码可能和本地测试分支存在差异，或者构建/打包脚本执行过程中自动修改了private字段（比如部分CI插件会临时设置private: true）
• npm配置差异：本地npm的默认access配置与Action环境不同，Action里的npm可能默认尝试私有发布，而你的包不符合私有包的条件
• 缓存干扰：Action环境残留的旧package-lock.json或npm缓存，导致npm解析包信息时出现异常

解决办法 #

• 强制指定发布权限：在GitHub Action的publish命令中明确添加--access=public，覆盖npm自动判断逻辑，命令示例：

  npm publish --access=public
  

• 验证package.json状态：在publish步骤前新增步骤，打印并确认private字段的值，避免文件被意外修改，示例步骤：

  - name: Check package.json private field
    run: cat package.json | grep private
  

• 调整package.json的private字段：
  • 显式添加"private": false到package.json中，消除npm的模糊判断
  • 若原本无private字段，可直接移除（显式声明false更稳妥）
• 清理缓存与依赖：
  • 删除package-lock.json并重新安装依赖，Action步骤示例：

    rm package-lock.json
    npm install
    

  • 清理npm缓存：

    npm cache clean --force
    

• 确认代码分支一致性：检查Release触发的分支是否与本地测试分支一致，避免拉取到未更新的代码版本

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