预加载对DB性能提升有限，仅加速类定义加载而非SQL执行；需精准预加载Connection、Builder等核心类，避免依赖顺序错误或权限问题。
预加载对 DB 库性能提升有限，除非你明确预加载了数据库驱动、连接器、查询构建器等核心类——但盲目这么做反而容易出错，比如 Can't preload unlinked class Illuminate\Database\Query\JoinClause: Unknown parent Illuminate\Database\Query\Builder 这类错误就是典型信号。
opcache.preload 配置后 DB 性能没变化？先确认是否真在生效
预加载不是“开了就快”，它只影响类定义加载阶段，不加速 SQL 执行或 PDO 连接本身。常见误区是以为设了 opcache.preload 就自动优化 DB——其实它连一个 PDO::query() 调用都不碰。
- 用
php -i | grep "opcache.preload"确认配置已加载，且路径存在、可读 - 检查 PHP-FPM 日志是否有
Failed to preload或Permission denied报错 - 运行
opcache_get_status()['preloaded_scripts']（需在 Web 请求中执行）看实际预加载了多少文件；空数组说明脚本根本没跑通 - Laravel 的 DB 类多数通过 Composer 自动加载器动态引入，若 preload.php 没覆盖
vendor/illuminate/database下关键路径，就等于没动 DB 相关类
preload.php 中该 include 还是 opcache_compile_file()？DB 类依赖链决定选法
Illuminate 数据库组件有强继承关系（如 JoinClause 继承 Builder），顺序错误会导致链接失败。两种方式行为差异极大：
-
include_once会执行代码，要求文件按依赖顺序加载（父类必须先于子类）；适合小范围手动控制，比如只预加载Connection.php和QueryBuilder.php -
opcache_compile_file()不执行代码，仅编译，允许乱序加载；更适合批量扫描vendor/illuminate/database/Query/目录，但无法处理条件逻辑（如if (class_exists('PDO')) { class PDOConnection { ... } }） - 混合使用风险高：同一个类被
include和opcache_compile_file()同时加载，可能触发 “Cannot redeclare class” - DB 相关常量（如
PDO::ATTR_ERRMODE）不会被预加载，仍需运行时加载；别指望靠 preload 减少define()开销
哪些 DB 类值得预加载？别全扫 vendor
全量预加载 vendor/ 是最省事也最危险的做法。Laravel DB 层真正高频、稳定、无条件加载的类其实很集中：
立即学习“PHP免费学习笔记（深入）”；
- 核心接口和基类：
vendor/illuminate/database/Connection.php、vendor/illuminate/database/Query/Builder.php、vendor/illuminate/database/Eloquent/Model.php - 常用驱动：
vendor/illuminate/database/Connectors/MySqlConnector.php（如果你用 MySQL） - 避免预加载测试类（
*Test.php）、命令行工具类（*Command.php）、带环境判断的工厂类（如含if (app()->environment() === 'local')的文件） - 不要碰
vendor/doctrine/dbal或vendor/laravel/framework/src/Illuminate/Database/下带Schema、Migrations的类——它们只在 Artisan 命令中用，Web 请求几乎不触达
重启后 DB 报错找不到类？检查 preload_user 权限和 autoloader 干扰
预加载脚本以 opcache.preload_user 指定用户身份运行，而 Laravel 的 Composer autoloader 是在请求时以 Web 用户身份执行的。两者若权限或环境不一致，就会出现“类已预加载却提示未定义”：
- 确保
opcache.preload_user与 PHP-FPM pool 的user/group一致（如都是www-data），否则文件读取失败，但错误静默 - 预加载脚本里不要调用
require vendor/autoload.php——这会触发完整 Composer 加载器，反而污染预加载上下文，导致重复定义或路径错乱 - 如果用了 Swoole 或 RoadRunner，注意它们有自己的类加载机制，与 OPcache 预加载不兼容；
opcache.preload在这些环境下基本无效 - Windows 系统直接跳过：预加载在 Windows 上完全不支持，文档白纸黑字写着
Preloading is not supported on Windows
真正起效的预加载，是精确识别 DB 层中那些每次请求都必然加载、且无运行时分支的类，并用 opcache_compile_file() 安全注入。多加一行无关文件，就可能让整个预加载失败，而错误日志里往往只有一行模糊的 “Unknown parent” 提示——这点最容易被忽略。
