如何解决 Composer 和 Node.js/NPM 在同一个 CI 流程中的冲突？

Composer 与 Node.js/NPM 在 CI 中冲突源于环境隔离不足、缓存混乱或执行顺序不当；应分步安装、重置 PATH、分开缓存、必要时采用多阶段构建。

Composer 和 Node.js/NPM 在同一个 CI 流程中冲突，本质是环境隔离不足、缓存策略混乱或执行顺序不当导致的。核心不是“它们不能共存”，而是默认配置下容易互相干扰（比如全局 bin 路径污染、依赖版本错乱、缓存复用错误）。解决的关键在于显式隔离、分步清理、精准缓存。

明确区分安装阶段与运行阶段

不要在同一个 shell 环境里混装 PHP 和 Node 依赖。CI 脚本中应严格分段：

• 先执行 composer install --no-dev --optimize-autoloader（PHP 依赖）
• 再执行 npm ci --no-audit --prefer-offline（Node 依赖，比 npm install 更可靠）
• 避免在安装后直接调用 npm run build 前还残留未清理的 Composer vendor/bin 或 node_modules/.bin 全局软链

禁用跨语言的 bin 路径污染

某些 CI 镜像（如 Ubuntu + php + node 预装镜像）会把 vendor/bin 和 node_modules/.bin 同时加进 $PATH，导致命令冲突（例如 phpunit 和 phpunit 的 Node 封装脚本同名）。

• 在 CI 脚本开头显式重置 PATH：export PATH="/usr/local/bin:/usr/bin:/bin"
• 需要调用特定工具时，用绝对路径或显式指定运行器：./vendor/bin/phpunit 或 npx jest
• 不依赖 npm bin 输出的路径自动注入

分开管理缓存，避免交叉失效

GitHub Actions、GitLab CI 等平台支持路径级缓存，但 Composer 和 NPM 缓存目录不同，必须分开声明：

标签： 依赖冲突 ci流程 php linux js 前端 node.js git node composer github n