结论：不要共享 vendor 卷。因各微服务 autoload.php 硬编码路径与依赖版本互斥，共用必致 Class not found 等错误；唯一安全复用的是 ~/.composer/cache/，vendor 必须构建进镜像并启用 classmap 权威加载。
共享 vendor 卷在微服务容器里根本不可行
直接说结论：不要尝试用 Docker volume 或 NFS 挂载同一个 vendor/ 目录给多个微服务容器共用。这不是配置技巧问题，而是会立刻触发 Class not found、Cannot declare class、require_once(): Failed opening required 'vendor/autoload.php' 这类确定性错误。
原因很硬：每个项目的 vendor/autoload.php 是根据自身 composer.json 的 PSR-4 映射和依赖版本生成的硬编码文件，路径和命名空间都绑定当前项目根目录。两个微服务（比如订单服务和用户服务）哪怕只差一个包的小版本，共用同一份 vendor/ 就必然有一方加载失败。
- 同一包不同版本无法物理共存（如
monolog/monolog:^2.9和^3.5） -
autoload.php里写死的__DIR__指向的是“构建时”的路径，不是运行时挂载点 - Composer 脚本、插件、平台配置（PHP 版本、扩展）差异会进一步放大冲突
真正该复用的只有 cache 和 dist 包，不是 vendor
微服务集群里唯一安全、官方支持的复用层是 ~/.composer/cache/ —— 它只缓存下载的 ZIP 包和校验和，不参与运行时加载。每个容器仍需独立执行 composer install，但能跳过网络下载。
- CI 流水线中提前拉取所有依赖：在构建镜像前运行
composer install --no-dev --prefer-dist，让 cache 填满 - 容器内挂载 cache 目录时，必须隔离 UID/GID：
volumes: ["${COMPOSER_CACHE_DIR:-$HOME/.composer/cache}:/root/.composer/cache"] - 避免挂载
~/.composer整体目录——它含 config、keys 等敏感项，且对 UID 更敏感 - Alpine 镜像注意：默认
/root/.composer不可写，建议统一用--user www-data并确保该用户有 cache 写权限
镜像构建阶段必须固化 vendor，而非运行时挂载
微服务容器启动快、扩缩容频繁，绝不能靠运行时挂载或 rsync 同步 vendor/。正确做法是把 vendor/ 当作构建产物，打包进镜像层。
- Dockerfile 中分层构建：
COPY composer.json composer.lock .→RUN composer install --no-dev --prefer-dist --optimize-autoloader --classmap-authoritative→COPY . . - 禁用
docker-compose.yml中对vendor/的 bind mount，否则会覆盖镜像内已装好的依赖 - 若开发阶段需热重载代码，只挂载
src/子目录：volumes: ["./src:/var/www/html/src:ro"] - 生产环境禁止使用
path类型仓库；本地开发可用{"type":"path","url":"../shared-lib"}，上线前必须切回 Git 或私有 Packagist
高密度场景下 autoload 性能比下载还致命
即使 vendor 已打包进镜像，若没关掉 autoload fallback，PHP 运行时仍会在每次 class_exists() 或自动加载时扫全目录——在 NFS 或云盘上，一次 scandir() 可能耗时数百毫秒，集群里几百个进程同时扫，IO 风暴就来了。
- 确认
composer.json含"optimize-autoloader": true - 安装命令必须带
--classmap-authoritative，否则autoload_classmap.php生效但 fallback 仍启用 - 验证方式：
grep -q "return array(" vendor/composer/autoload_classmap.php应返回成功，且代码中避免动态拼类名（如class_exists("App\".$name)） - 类映射文件必须只读：
chmod -R a-w /app/vendor，防止运行时意外写入或重建
真正卡住微服务集群的，往往不是 Composer 下载慢，而是 autoload 机制在非本地 SSD 存储上的反复元数据操作。这点比镜像大小或构建时间更值得优先排查。
