根本原因是宿主机挂载的 vendor 目录被 root 写入后，容器内非 root 用户（如 www-data）无法覆盖或删除其中文件，导致“Permission denied”。
composer install 在容器里报 “Permission denied”
根本原因不是权限没给够，而是宿主机挂载的 vendor 目录被 root 写入后，容器内非 root 用户（比如 www-data）无法覆盖或删除其中文件。Docker 默认以 root 启动 composer 容器，但很多 PHP 运行容器会切到低权限用户。
- 运行
composer install时加--no-scripts --no-plugins减少干扰，先看是不是权限卡在 autoload 生成阶段 - 确保
vendor/不从宿主机挂载进构建阶段；构建镜像时用RUN composer install --no-dev，而不是运行时挂载宿主 vendor - 如果必须挂载（如开发环境），在
Dockerfile中提前创建目录并 chown：RUN mkdir -p /app/vendor && chown www-data:www-data /app/vendor - 避免用
docker run -v $(pwd)/vendor:/app/vendor直接映射——宿主机的 uid/gid 和容器不一致，Linux 下权限直接失效
PHP 版本不匹配导致 composer install 失败
宿主机装的 composer 会读取本地 PHP 版本判断依赖兼容性，但容器里实际跑的是另一个版本。常见现象是 composer install 成功，但容器启动时报 Class not found 或 ParseError: syntax error, unexpected token。
- 不要在宿主机执行
composer install后再 COPY 到容器——这等于把“为 PHP 8.1 编译的 vendor”塞进 PHP 8.2 容器 - 务必在容器内执行安装：用
docker run --rm -v $(pwd):/app -w /app php:8.2-cli composer install --no-dev - 检查
composer.json的config.platform.php是否锁定错误版本，例如写成"8.1"却在 8.2 容器里跑，会导致某些包降级或跳过安装 -
composer show php在容器里执行，确认它看到的 PHP 版本和php -v一致；不一致说明PATH或php.ini加载路径有问题
如何让 composer 使用国内镜像且不污染项目配置
全局改 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 看似省事，但会污染所有项目，CI 环境容易出错。更稳妥的做法是只对当前构建生效。
- 构建镜像时，在
RUN指令中临时设置：RUN composer config -g repos.packagist composer https://mirrors.aliyun.com/composer/ && composer install --no-dev - 或者更干净：用
-d参数传入配置文件路径，配合--no-plugins避免插件干扰：composer install --no-dev -d /tmp/composer-config.json，其中/tmp/composer-config.json是预置的镜像配置 - 注意阿里云镜像偶尔同步延迟，若遇到
Could not find package xxx，可临时切回官方源验证是否镜像问题：composer config -g repo.packagist composer https://packagist.org - 别在
composer.json里硬编码镜像地址——这会让团队成员本地开发也走镜像，而他们可能没配好认证或代理
多阶段构建中 vendor 体积过大或丢失 autoload
常见于用 FROM php:8.2-cli AS builder 装完依赖后，COPY 到生产镜像却提示 Class 'Composer\Autoload\ClassLoader' not found，本质是 autoload 文件生成路径与运行时不符。
- 确保两阶段使用相同工作目录，比如都设为
/app；否则vendor/autoload.php里写的路径前缀会错位 - 不要只 COPY
vendor/，要一起 COPYvendor/autoload.php和vendor/composer/autoload_*.php——这些是动态生成的，漏一个就加载失败 - 用
composer dump-autoload --optimize --classmap-authoritative替代默认 install，能减少运行时扫描，也避免因文件缺失导致 classmap 找不到类 - 如果最终镜像里
vendor/还是太大，检查有没有误把dev-dependencies装进生产镜像：构建阶段用--no-dev，且composer.json的config.autoload-dev不要影响主 autoload
