应提交 composer.lock 到 Git、CI/CD 中只用 composer install、修复损坏 lock 文件、锁定关键依赖版本、配置 platform 字段适配线上环境。
如果您在本地开发环境运行正常，但线上部署后出现 Class not found、Method does not exist 或类型错误等异常，则极可能是由于 PHP 依赖版本不一致所致。Composer.lock 文件正是为解决此类问题而存在——它强制约束所有环境安装完全相同的依赖快照。以下是确保线上环境稳定运行的关键操作：
一、确认 composer.lock 已提交至 Git 仓库
composer.lock 是依赖状态的权威快照，未提交即等于放弃环境一致性保障。Git 忽略该文件会导致每次 composer install 都退化为隐式依赖重解析，结果不可控。
1、执行 git check-ignore -v composer.lock，验证其未被 .gitignore 错误排除。
2、若输出显示匹配规则，需立即从 .gitignore 中删除对应行，并执行 git add -f composer.lock 强制添加。
立即学习“PHP免费学习笔记（深入）”；
3、运行 git status 确认 composer.lock 处于待提交状态，随后提交并推送到远程分支。
二、CI/CD 流水线中严格使用 composer install
CI/CD 环境必须以 composer.lock 为唯一安装依据，禁止任何场景下调用 composer update，否则将生成新 lock 文件，彻底破坏构建可重现性。
1、在 CI 脚本中替换所有 composer update 为 composer install --no-interaction --no-progress。
2、在拉取代码后、执行 install 前，加入校验步骤：composer install --dry-run，若报错 “lock file is not up to date”，说明 composer.json 与 lock 不一致，应中断流程并通知开发者修复。
3、确保 CI 运行用户拥有对 vendor/ 目录的完整写权限，避免因权限不足导致部分包未安装却无显式失败。
三、修复已损坏或缺失的 composer.lock
当线上报错且确认 lock 文件丢失、格式损坏或 content-hash 校验失败时，需谨慎重建锁文件，避免引入未经验证的版本变更。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
1、若确认本地 composer.json 无未提交修改，且当前 vendor 与历史行为无关，可执行 rm composer.lock 彻底清除旧锁。
2、运行 composer update --lock，该命令仅重写 lock 文件而不更改 vendor 目录，适用于同步 content-hash 或平台字段变更。
3、执行 composer install --dry-run 验证新 lock 是否能正确映射现有 vendor；若失败，改用 composer update --with-all-dependencies 并配合完整测试回归。
四、锁定特定依赖防止意外升级
某些关键组件（如 monolog/monolog、guzzlehttp/guzzle）一旦发生次版本或修订号升级，可能触发 BC break 或子依赖不兼容。需通过 composer.json 显式固定其精确版本。
1、编辑 composer.json，在 require 段中将版本约束由 "^2.0" 改为 "2.10.2"（不含 ^ 或 ~ 符号）。
2、保存后运行 composer update monolog/monolog，仅更新该包及其直接兼容子依赖，避免全量重解析。
3、检查输出中是否包含非预期包变动，若有，立即中止并回退；确认无误后，提交更新后的 composer.lock。
五、配置 platform 字段适配目标运行环境
当线上服务器 PHP 版本或扩展（如 ext-intl、ext-gd）与开发者本地不一致时，即使 lock 文件相同，composer install 仍可能失败——因 lock 中记录的 platform 信息参与依赖求解。
1、在 composer.json 的 config 段下添加 platform 配置："platform": {"php": "8.1.27", "ext-intl": "8.1.27"}。
2、运行 composer update --lock 使 lock 文件中的 platform 字段与线上环境对齐。
3、将更新后的 composer.lock 提交，并确保 CI 和线上部署均使用该锁定环境执行 composer install。
