class not found 但 vendor/autoload.php 已引入，是缓存指向错乱所致：opcache 缓存旧 autoload_static.php、docker/符号链接导致 dir 失效、classmap 静默跳过非法文件，需检查 opcache 状态、用绝对路径绕过 __dir__、加 -v 参数验证扫描日志。
vendor/autoload.php 被引入但 Class not found 是缓存指向错乱的典型表现
这问题常被误判为“自动加载没生效”，实际是 vendor/autoload.php 加载了，但里面引用的映射文件（如 autoload_classmap.php、autoload_psr4.php）路径失效或内容陈旧。最常见于：Docker 容器挂载、IDE 同步延迟、OPcache 缓存了旧的 autoload_static.php、或 composer dump-autoload 执行位置不对导致生成路径绑定到错误目录。
验证方式很简单：在报错脚本开头加一行：
var_dump(include_once __DIR__ . '/vendor/autoload.php');
如果输出 bool(true) 但后续仍 Class not found，说明 autoload.php 自身没问题，问题出在它内部加载的子文件上。
检查 autoload_static.php 是否被 OPcache 缓存了旧版本
autoload_static.php 是 composer dump-autoload -o 生成的静态映射，PHP 的 OPcache 会把它整个编译缓存。一旦你改了 composer.json 或类路径，但没清 OPcache，PHP 就还在用旧的类路径映射。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 运行
php -r "opcache_get_status();"看scripts列表里是否包含vendor/composer/autoload_static.php且timestamp比你最近一次dump-autoload时间早 - 临时禁用验证：在
php.ini加opcache.validate_timestamps=1，再重启 PHP-FPM 或 Apache - 生产环境别用
opcache_reset()，直接重启服务更稳妥；开发机可执行php -r "opcache_reset();" - 注意：某些 SAPI（如 PHP built-in server）不支持 OPcache，此时问题大概率出在
__DIR__绑定上
Docker 或符号链接下 __DIR__ 失效导致 PSR-4 映射全空
Composer 生成的 autoload 文件里大量使用 __DIR__ 拼接路径，比如 __DIR__ . '/../src/'。当 vendor/ 是通过符号链接挂载，或 Docker 把宿主机目录 bind mount 到容器内时，__DIR__ 可能指向一个空目录或不存在路径，最终所有 PSR-4 映射都变成无效路径。
- 进容器执行
ls -l vendor/composer/，看autoload_*.php文件是否真实存在，而非 broken link - 检查
vendor/autoload.php第一行：require_once __DIR__ . '/composer/autoload_real.php';—— 如果__DIR__错了，这行就直接失败，但 PHP 不报错，只静默跳过 - 临时修复：在入口脚本里手动重写 autoload 路径，例如：
require_once '/app/vendor/composer/autoload_real.php';（用绝对路径绕过__DIR__） - 根治方案：用
composer install --no-scripts --no-plugins+composer dump-autoload --classmap-authoritative强制生成不依赖__DIR__的 classmap，但会失去 PSR-4 动态发现能力
classmap 扫描跳过非法文件却不报错，导致部分类“消失”
Composer 的 classmap 扫描器遇到非 .php 文件（如 .php5、.inc）、语法错误文件、或空文件时，默认静默跳过，不会中断也不会警告。结果就是你明明写了类，却始终 Class not found，而 composer dump-autoload -v 输出里根本看不到它。
- 加
-v参数重跑：composer dump-autoload -v，观察扫描日志里有没有 “Skipped” 或 “Parse error” 提示 - 检查目标目录下是否有隐藏文件：
ls -a src/，特别留意.DS_Store、.gitignore未排除的临时文件 - 确认类文件扩展名是
.php，不是.php~或编辑器备份文件 - 如果必须用非标准扩展名，得在
composer.json里显式配置："autoload": {"classmap": ["src/", {"suffix": ".php5"}]}（需 Composer 2.5+）
真正棘手的不是找不到类，而是“看起来一切正常”的时候——autoload.php 存在、dump-autoload 成功、甚至 class_exists() 返回 true，但某个特定环境（比如 CLI vs Web、容器 vs 本地）下类路径就悄悄偏移了。这时候得盯住 __DIR__ 和 OPcache 两个变量，它们才是缓存指向错乱的幕后推手。
