Ansible 中直接用 composer install 失败，是因为默认以 root 执行，但 PHP-FPM 等实际运行用户（如 www-data）无权访问 root 的 Composer 配置和缓存目录，导致网络请求失败、权限拒绝或 lock 文件校验错误；须通过 become_user 显式切换用户，并配合 environment 设置 HOME 和 COMPOSER_HOME，同时为该用户单独初始化镜像源。
为什么直接用 composer install 在 Ansible 里跑会失败？
因为默认情况下，Ansible 以 root 用户执行命令，但 PHP-FPM 或 CLI 实际运行时用的是 www-data、nginx 等低权限用户。这些用户的 $COMPOSER_HOME 指向各自家目录（比如 /var/www/.composer），而该目录往往不存在、不可写，或没初始化过 Composer 配置。
常见错误现象：
-
Could not fetch https://packagist.org/packages.json—— 不是网络问题，是当前用户没配置国内源，又没权限写缓存 -
Failed to write /var/www/.composer/auth.json—— 目录不存在或权限不足 -
composer.lock is not valid—— 因为root用户下生成的 lock 文件被低权限用户读取时校验失败（尤其在 Composer 2.5+）
如何让 composer install 在目标节点上以正确用户身份运行？
关键不是“切用户”，而是“指定用户上下文 + 确保环境一致”。Ansible 的 become_user 必须配合 environment 显式注入 HOME 和 COMPOSER_HOME，否则即使切了用户，Composer 仍可能 fallback 到 root 的路径。
实操建议：
- 在 playbook 中对
composer install任务显式设置：become_user: www-data，并添加environment块 -
HOME必须设为该用户的家目录（如/var/www），否则~/.composer解析失败 -
COMPOSER_HOME显式设为{{ ansible_env.HOME }}/.composer，避免依赖系统默认逻辑 - 确保目标用户家目录存在且可写：
file: path=/var/www state=directory owner=www-data group=www-data mode='0755'
怎么批量分发 composer.lock 并确保它被严格使用？
composer install 是否真正按 lock 文件安装，取决于两个条件：lock 文件存在 + 当前用户有权限读取它。集群中常因路径不一致或权限错位导致 fallback 到 composer.json 解析，从而引入意外版本。
必须检查的点：
-
composer.lock文件需和composer.json同级，且由部署用户（如www-data）拥有：chown www-data:www-data composer.lock - 禁止在 playbook 中漏掉
--no-dev参数——生产环境多一个 dev 依赖都可能引发 autoload 冲突 - Composer 2.5+ 默认开启 strict lock 检查：若 lock 文件里缺失
composer.json中声明的包，install直接报错，不能跳过 - 推荐加
--ignore-platform-reqs仅用于边缘节点架构差异（如 ARM vs x86），但需明确记录并测试，不要无脑加
Ansible 批量配国内源为什么不能只跑 composer config -g？
因为 -g（global）写的是当前执行用户的全局配置，而 www-data 用户根本不会读 root 的 .composer/config.json。强行配只会让 root 用户能用镜像，实际运行的服务依旧走官方源，超时卡死。
正确做法是：为每个目标用户单独初始化 Composer 并设源。例如：
- name: init composer for www-data and set aliyun mirror
command: >
sudo -u www-data sh -c 'COMPOSER_HOME=/var/www/.composer composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/'
args:
creates: /var/www/.composer/config.json
注意点：
- 必须用
sudo -u www-data+ 显式COMPOSER_HOME，不能依赖 become_user 自动继承 -
creates参数防止重复执行（幂等性），否则每次都会重写 config.json - 镜像地址选阿里云或腾讯云即可，
https://开头，别漏证书验证环节
复杂点在于：不同节点可能用不同 Web 用户（nginx、apache、www-data），得按角色动态注入用户变量，而不是硬编码。
