只读文件系统下autoload出问题，是因为composer dump-autoload等命令需写入autoload_classmap.php等文件，而php进程无写权限；必须在构建阶段用composer install --optimize-autoloader --no-dev预生成静态autoload文件，并确保opcache启用且validate_timestamps=0。
为什么只读文件系统下 autoload 会出问题
vendor/ 目录设为只读后，composer dump-autoload、composer install 等命令会直接失败，报错类似：file_put_contents(vendor/composer/autoload_classmap.php): failed to open stream: Permission denied。这不是 autoload 本身的问题，而是 Composer 在生成或更新自动加载文件时默认尝试写入 vendor/ 下的多个 PHP 文件（如 autoload_classmap.php、autoload_static.php）。只要 PHP 进程没有写权限，哪怕只是想“读取”已有的 autoload，也会在初始化阶段因检测失败而中断。
只读环境下必须提前固化 autoload 文件
只读部署的本质是“禁止运行时生成”，所以所有 autoload 文件必须在构建阶段（build time）一次性生成完毕，并确保它们不依赖后续写操作。关键动作不是“禁用 autoload”，而是“让 autoload 完全静态化”：
- 构建镜像或打包前，必须执行完整命令：
composer install --optimize-autoloader --no-dev --prefer-dist；仅跑dump-autoload --optimize不够——它不装包，vendor/ 里可能缺依赖，classmap 也扫不全 - 确认
vendor/composer/autoload_classmap.php和vendor/composer/autoload_static.php都存在且非空；后者在 Composer 2+ 中才是主力，比 classmap 更轻、更易被 opcache 缓存 - 避免在
composer.json中配置"apcu-autoloader": true或"classmap-authoritative": true——前者需运行时写 APCu，后者在找不到类时不 fallback，但只读环境无法补救错误，容易掩盖路径/命名空间拼写问题
只读 + opcache 是硬绑定关系
只读文件系统本身不提速，它只是强制你把 autoload 变成“一次写、永久读”。真正起效的是 opcache 对这些静态文件的缓存行为：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 必须启用
opcache.enable=1和opcache.enable_cli=1（CLI 场景如队列、定时任务也依赖） -
opcache.validate_timestamps=0必须关闭——否则每次请求仍会 stat 文件修改时间，而只读文件系统上这个检查可能因挂载方式异常变慢 - 验证是否生效：用
opcache_get_status()['scripts']查看vendor/autoload.php和autoload_static.php是否在缓存中，且hits持续增长
常见翻车点：.gitignore / build 工具误删 autoload 文件
很多 CI/CD 流水线或 Docker 构建脚本会在最后执行 rm -rf .git 或清理未跟踪文件，结果把 vendor/composer/autoload_*.php 一并清掉——因为这些文件不在 git 中，也不在 .dockerignore 白名单里。结果容器启动时报 Class 'Composer\Autoload\ClassLoader' not found。
解决方法很简单：构建阶段末尾加一行 touch vendor/composer/autoload_*.php，或在 .dockerignore 中显式保留 !vendor/composer/autoload_*.php。最稳妥的是在 Dockerfile 里把 composer install 放在 COPY 代码之后、任何清理动作之前。
