Docker运行的PHP应用高负载下Page类未找到报错如何解决？

排查建议 #

1. 优先排查PHP Opcache配置问题 #

• 检查opcache.max_accelerated_files配置值，若项目总文件数超过该阈值，高负载下频繁的类加载会把不常用的类从opcache中挤出，触发类找不到报错。
• 检查opcache.memory_consumption配置，若分配的opcache内存不足，同样会触发缓存淘汰导致类加载失败，可同步统计opcache命中率验证是否存在缓存失效问题。
• 若开启了opcache.validate_timestamps，高负载下磁盘IO性能不足时，PHP校验类文件时间戳失败会直接认为文件不存在，导致类加载报错。

2. 排查Docker容器资源与运行时问题 #

• 核查容器的内存、CPU、磁盘IO限制，高负载下是否触发OOM killer杀掉PHP进程，或磁盘IO被打满导致类文件读取失败。
• 确认容器存储驱动是否为overlay2，高并发下是否存在文件系统竞态问题，导致vendor目录下的类文件读取异常。

3. 排查SilverStripe框架缓存问题 #

• SilverStripe会自动生成类映射缓存存储在临时目录，检查高负载下是否存在缓存文件并发写入损坏、或临时目录使用tmpfs时内存占满导致缓存文件丢失的情况。
• 若报错出现在部署发布后，确认是否是缓存清空重建的间隙，请求提前进入导致类映射还未生成就加载了ErrorPage类。

4. 排查Composer自动加载配置问题 #

• 确认composer.json的autoload配置是否正确覆盖了Page类所在的目录，根命名空间的映射关系是否正常。
• 检查是否开启了composer dump-autoload --optimize生成优化级自动加载映射，未开启时高负载下自动加载遍历目录查找类文件的逻辑很容易因IO不足失败。
• 确认vendor目录及Page类所在目录的读写权限正常，PHP运行进程拥有文件读取权限。

临时规避方案 #

可先将ErrorPage.php中的use Page;修改为use \Page;明确指定根命名空间，或在ErrorPage类加载前手动引入Page类的实体文件，先缓解线上报错再定位根因。

内容的提问来源于stack exchange，提问作者apark