php-fpm reload期间并发执行composer dump-autoload会导致autoload_classmap.php被不完整读取，引发class not found等偶发错误；根本原因是reload不阻塞请求且dump-autoload非原子操作，应将dump-autoload移至构建阶段并配合opcache重置或fpm restart。
PHP-FPM reload 时 vendor/autoload.php 被并发读写
PHP-FPM reload（非 restart）期间，master 进程会 fork 新 worker，但旧 worker 仍在处理请求，此时若恰好有请求触发 vendor/autoload.php 加载，而另一进程正在执行 composer dump-autoload，就可能读到半截的 autoload 文件——尤其 autoload_classmap.php 是先写临时文件再 rename，但 PHP 的 include 不保证原子性，容易遇到 Parse error: syntax error, unexpected '}' 或空数组反序列化失败。
- 现象：reload 后偶发
Fatal error: Class 'App\Services\UserService' not found，但几秒后又恢复正常 - 根本原因不是类没注册，而是
autoload_classmap.php在重写过程中被 worker 进程加载了不完整内容 - PHP-FPM 的 reload 不阻塞请求，
dump-autoload也不是原子操作，两者天然冲突 - 避免方式：绝不在线上 reload 阶段执行
composer dump-autoload；CI/CD 中应把该命令放在构建镜像阶段，而非容器启动时
OPcache 缓存未失效导致 classmap 更新被忽略
即使 vendor/composer/autoload_classmap.php 已更新，若 OPcache 没清空，PHP 仍会从共享内存中返回旧版本——这在 opcache.validate_timestamps=0 的生产配置下尤为明显，dump-autoload 执行成功也毫无意义。
- 确认方法：访问一个新类，用
var_dump(opcache_get_status()['scripts']['vendor/composer/autoload_classmap.php']['timestamp'])对比文件实际 mtime -
sudo systemctl restart php8.2-fpm比reload更可靠，它强制清空 OPcache 共享内存 - 如果必须 reload，需在命令后加
opcache_reset()（仅当opcache.enable_cli=1且 CLI 与 Web 使用同一 OPcache 实例时才生效） - 注意：CLI 环境默认关闭 OPcache，
composer dump-autoload在本地跑完看不到效果，不代表线上也生效
classmap-authoritative + dump-autoload 在热更场景下的陷阱
启用 --classmap-authoritative 后，Composer 完全跳过 PSR-4 动态查找，只查 autoload_classmap.php。这意味着：一旦你在线上新增一个类但忘了重新 dump-autoload -o -a，就会立刻报 Class not found，没有任何 fallback。
- 这不是 bug，是设计行为：authoritative 模式本就要求 classmap 必须 100% 覆盖运行时所有类
- 热更新类文件（如通过 FTP 上传）后，必须同步执行
composer dump-autoload -o -a并重启 PHP-FPM，否则必然失败 - 开发环境慎用
-a：改一行代码就得跑命令，IDE 自动补全可能误导你“类存在”，实际运行时崩 - 检查是否生效：打开
vendor/composer/autoload_classmap.php，搜索你的类名；若找不到，说明 classmap 没扫到，常见原因是路径没配进composer.json的autoload段
为什么 dump-autoload -o 在热重启时反而拖慢首请求
composer dump-autoload -o 在 PHP 7.4+ 和 Composer 2.x 下生成的是全量 autoload_classmap.php，体积常达数 MB。每次请求都要反序列化整个数组，而实际只用到其中不到 5% 的类——冷启动时 IO 和内存开销远高于轻量的 autoload_static.php。
- 真正该用的是
composer install --no-dev --optimize-autoloader，它生成精简 classmap，并启用autoload_static.php作为主加载器 -
dump-autoload -o不重建 classmap，只是刷新映射；它甚至不会扫描require-dev目录，导致测试类漏进生产 classmap - 容器部署时，应禁止在 entrypoint 中调用
dump-autoload；它应在构建阶段完成，且必须配合--no-dev - 若项目含
"files"类型 autoload（如全局 helper 函数），-o会将其写入 classmap，但重复 require 可能触发Fatal error: Cannot redeclare
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
