dump-autoload -o 爆内存是因为它扫描了 autoload 配置中不该包含的非代码目录（如 logs/、dist/、node_modules/ 或大体积 JSON/YAML 文件），导致类映射阶段内存激增；应通过 --no-scripts --verbose 定位扫描路径，清理或注释可疑配置，并优先用 php -d memory_limit=1.5G composer dump-autoload -o --no-dev 应急。
composer dump-autoload -o 报 Allowed memory size exhausted，说明类扫描阶段吃掉了太多内存——不是优化本身有问题，而是它在扫不该扫的目录或文件。
为什么 dump-autoload -o 会爆内存
开启 -o（即 "optimize-autoloader": true）后，Composer 会遍历所有 autoload 和 autoload-dev 配置下的路径，逐个读取 PHP 文件、解析 class/interface/trait 声明，并生成 vendor/composer/autoload_classmap.php。一旦路径里混入大体积非代码文件（如 JSON 配置、日志、node_modules/），或 autoload 配置范围过宽，就会触发内存告警。
- 常见错误现象：命令卡住几秒后直接报错，没输出具体文件名；
vendor/autoload.php生成失败但composer install成功 - 典型诱因：
composer.json中autoload包含了"dist/"或"build/"；项目根目录下有未忽略的storage/app/或logs/ - 注意：
-o不会扫描vendor/内部（那是 Composer 自己控制的），只扫你配置的源码路径
怎么快速定位并剔除干扰路径
别猜，用 --no-scripts --verbose 暴露真实扫描行为：
composer dump-autoload -o --no-scripts --verbose
观察输出末尾的 “Scanning” 行，看它实际进了哪些目录。再对照 composer.json 的 autoload 字段，检查是否有以下问题：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
"psr-4": {"App\": "src/"}后面多加了一条{"Tests\": "tests/"}，但tests/下有 200MB 的测试数据集 -
"classmap": ["database/", "config/"]里config/下塞了 50MB 的 YAML/JSON 元数据文件 -
autoload-dev包含了"scripts/"，而该目录下是 Webpack 构建产物
临时注释掉可疑路径，再试 dump-autoload -o，逐步缩小范围。
dump-autoload -o 爆内存时的应急方案
如果必须立刻生成优化映射，又来不及清理路径，优先用内存参数绕过，但要控制粒度：
- 加内存只给当前命令：运行
php -d memory_limit=1.5G composer dump-autoload -o（比-1更稳，避免 OOM killer 杀进程） - 跳过 dev 路径减少扫描量：加
--no-dev，它会忽略autoload-dev配置，适合生产环境构建 - 禁用插件防止预加载：加
--no-plugins，某些自定义插件会在扫描前把整个vendor/类全 require 进来 - 确认
vendor/是干净的：运行composer clear-cache，旧缓存损坏可能导致解析异常膨胀
Docker/CI 环境下特别要注意的点
在容器里跑 dump-autoload -o 容易失败，因为默认内存限制更严，且挂载卷可能引入宿主机的冗余文件：
- GitLab CI 示例：
php -d memory_limit=1.5G /usr/bin/composer dump-autoload -o --no-dev（显式调用 php + 限定路径） - Docker 构建时：确保
docker build的--memory=3g和 PHP 的-d memory_limit同步调大，否则容器内存不足，PHP 参数再大也没用 - GitHub Actions：用
composer/setup-phpAction 时，必须设memory-limit: 1536M，仅靠COMPOSER_MEMORY_LIMIT不生效
最常被忽略的是：dump-autoload -o 在 CI 中通常没必要——它只影响自动加载性能，不影响功能；真正需要它的场景是生产镜像构建，且应配合 --classmap-authoritative 或 --apcu-autoloader 一起用，单独开 -o 收益有限却风险更高。
