不能在宿主机装完再复制vendor，因vendor中autoload.php和installed.json绑定容器php版本、扩展等环境，宿主机与容器稍有差异就会导致类找不到或函数未定义。
直接在宿主机跑 composer install 再把 vendor/ 复制进容器，99% 会出问题——类找不到、扩展报错、autoload 失效，不是运气差，是环境绑定太强。
为什么不能在宿主机装完再复制 vendor
Composer 生成的 vendor/autoload.php 和 vendor/composer/installed.json 里隐含了 PHP 版本、已启用扩展（如 ext-pdo、ext-mbstring）、甚至 opcache 状态。宿主机和容器的 PHP 小版本或扩展列表只要有一处不一致，运行时就可能抛 Class not found 或 Call to undefined function mb_strlen()。
- 用
php -v和php -m进容器确认真实环境，别信镜像标签名（比如php:8.2-cli默认不带gd） -
composer.lock顶部的platform字段若没显式声明php和扩展版本，本地锁的依赖可能在容器里根本无法解析 - 即使强行绕过（
--ignore-platform-reqs），上线后某天扩展被启用或禁用，就会突然崩
Dockerfile 构建时安装依赖（推荐用于生产）
这是最稳的方式：所有依赖在目标 PHP 环境里安装，打包进镜像，启动即用。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
-
COPY composer.json composer.lock ./必须放在COPY . .之前——这样 Docker 层缓存才生效；改代码不会触发重装依赖 - 国内务必换源：
RUN composer config -g repo.packagist https://mirrors.aliyun.com/composer/（旧的phpcomposer.com已停用） - 加
--no-dev --optimize-autoloader --prefer-dist --no-interaction，减少体积、提升加载速度、避免交互卡住构建 - 不要在
WORKDIR里git clone后再composer install——这会让整个安装步骤无法被缓存
docker-compose 中怎么安全执行 composer install
别在 docker-compose.yml 里定义一个长期运行的 composer 服务——它不是 Web 服务，起起来就退出，纯属绕路。
- 开发时想“按需安装”，用
entrypoint脚本检查vendor/autoload.php是否存在，缺失再拉一次临时容器执行：docker run --rm -v $(pwd):/app -w /app --user $(id -u):$(id -g) composer:2-php8.2 install --no-interaction - CI/CD 或本地部署，直接用官方镜像一次性执行：
docker run --rm -v $(pwd):/app -w /app composer:2-php8.2 install --no-dev - 关键点有三个：挂载路径对、PHP 版本匹配（用
composer:2-php8.2这类带 PHP 的镜像）、加--user避免生成的vendor/文件权限错乱
多阶段构建中 vendor 复制失败的常见原因
很多教程只写 COPY --from=builder /app/vendor /app/vendor，但实际跑起来 autoload 报错或类找不到，往往是因为两个阶段的环境不一致。
- builder 阶段和 final 阶段必须用**完全相同的基础镜像标签**，例如都用
php:8.2-cli，别 builder 用cli、final 用apache——后者缺zip扩展会导致某些包的 autoloader 生成异常 - builder 阶段装完依赖后，建议加一步
composer dump-autoload --optimize，减少运行时解析开销 - final 镜像里如果删了
composer命令本身没问题，但别删/root/.composer/目录以外的缓存文件——有些包的安装脚本（post-install-cmd）可能依赖它
最易被忽略的一点：多阶段构建里，composer install 在 builder 阶段执行时，必须确保 composer.json 中声明的扩展（如 "ext-pdo": "*"）已在 builder 镜像中真实启用，否则 dump-autoload 生成的映射可能漏掉某些类——而这个错误直到运行时才暴露，且难以复现。
