Composer报错“Your requirements could not be resolved”或PHP版本不匹配，根本原因是composer.json未声明PHP约束（如"php": ">=8.1.0"），导致不同环境生成的composer.lock不兼容；应统一require段约束、避免config.platform.php提交、显式指定PHP路径执行install，禁用--ignore-platform-reqs以防运行时崩溃。
你的PHP版本和composer.lock不匹配
报错信息里出现 Your requirements could not be resolved 或明确提示 PHP 版本不符（比如 requires php ^8.1 but your PHP version (7.4.33)），说明你本地的 php -v 和 composer.lock 里锁定的包要求冲突。这不是你电脑“坏了”，而是团队没统一约束入口。
-
composer.json的require段必须写死 PHP 版本，例如"php": ">=8.1.0"—— 不是可选，是强制校验起点 - 如果别人机器上
php -v是 8.2、你的是 7.4，而composer.json里没声明php，Composer 就默认“能装啥装啥”，结果生成的composer.lock会记录 8.2 下可用的包版本，你一跑composer install就卡住 -
config.platform.php是假环境，只该出现在 CI 脚本里，绝不能提交进 Git；它骗得过安装，骗不过运行时，比如match表达式在 7.4 直接 fatal
Composer 实际调用的 PHP 不是你以为的那个
你敲 php -v 看到 8.1，但 composer install 仍报 7.4，说明 Composer 启动时加载的是另一个 PHP 二进制。Windows 和 macOS 尤其常见。
- 运行
which php（macOS/Linux）或where php（Windows），再执行composer diagnose | grep "PHP binary"，两行路径必须完全一致 - 常见干扰源：宝塔面板的 wrapper 脚本、IDE 自带 PHP、通过
brew install php@8.1安装但未brew link php@8.1、Windows 下多个php.exe在 PATH 里乱序 - 临时绕过：直接用完整路径调用，比如
/usr/local/bin/php81 composer install或"C:\php\8.1\php.exe" composer install
你用了 --ignore-platform-reqs 却没意识到后果
加了这个参数确实能跳过报错，但只是把问题从安装阶段推迟到运行阶段——类加载失败、语法错误、扩展缺失全堆在第一次请求时爆发，更难定位。
-
--ignore-platform-reqs会同时跳过 PHP 版本、扩展（ext-mbstring）、ICU 版本等全部检查 - 如果只是为了“先装上”，请改用
--ignore-platform-req=php，至少保留扩展校验 - CI/CD 脚本里绝对禁止出现这个参数；本地调试后务必删掉，否则会污染
composer.lock
vendor/ 或 composer.lock 权限被 root 污染过
报错含 Permission denied，尤其出现在写 vendor/autoload.php 或修改 composer.lock 时，大概率是之前用 sudo composer install 导致目录归属变成 root。
- 检查命令输出里出错的路径，比如
file_put_contents(/path/to/vendor/autoload.php): Permission denied→ 问题就在vendor/ - 运行
ls -ld vendor/ composer.lock，看 owner 是否为当前用户；不是就执行sudo chown -R $USER:$USER vendor/ composer.lock（macOS/Linux）或右键属性 → 安全 → 编辑权限（Windows） - 别用
chmod 777，这解决不了归属问题，反而引入安全风险
composer.json 少了一行 "php": ">=8.1.0"、或者 vendor 目录静静躺在 root 手里。 
