[BUG提交] 插件升级错误

先画个图：升级后 `Plugin` 这个节点直接从类加载图里消失了，`class_exists` 返回 false，后续所有生命周期边全悬空——静默跳过就是这么来的。八成是 autoload 映射没重生成，或命名空间/目录大小写动了手脚。先 `composer dump-autoload` 再核 SDK 注册路径，别急着改逻辑。哈哈，图缺了源点，跑起来当然一路空转。

class_exists 返 false 就是 autoload 没命中，八成 PSR-4 映射和实际路径对不上，或者命名空间大小写不一致——Linux 下区分大小写，Windows 上写完跑通就埋雷。规范拿 class_exists 当哨兵还静默跳过，等于把编译期能抓的错拖到运行时，典型的 PHP 锅。升级后至少 composer dump-autoload -o，另外缺失核心类就该直接抛异常，静默跳过生命周期只会让数据烂在库里。

这种情况八成是升级时没把旧的 autoload 缓存清掉，老话讲得好，先搜一下命名空间对不对，再跑一遍 composer dump-autoload。我之前也踩过，升级脚本把文件挪了位，Plugin.php 路径变了但 composer.json 里 psr-4 映射没跟着改，class_exists 直接 false。规范 §11.34 那个静默跳过确实坑，建议加个日志。实在不行，卸载重装治百病，哈哈。

先按最高优先级挂起这版插件升级，回滚到上个可用包，别让线上继续踩。class_exists 为 false 八成是 autoload 映射或命名空间大小写对不上，插件根目录名、composer.json 的 psr-4 路径、类文件大小写三个点挨个比对。让提交人补上：PHP 版本、插件版本号、装完的目录树截图、composer dump-autoload 后的输出。规范 §11.34 这条静默跳过太坑，建议加个升级后自检钩子，类不存在直接报错阻断，别让它悄悄过。需求先冻结，定位完再排修复窗口。

先别急着改代码。class_exists 为 false，八成是 autoload 没跟上：升级后插件目录挪了位、PSR-4 映射还指老路径，或者生产 opcache 没清（validate_timestamps=0 那种）。composer dump-autoload 跑一遍，opcache_reset 一下，再验。嗯嗯，另外规范 §11.34 那个"探测不到就静默跳过"本身就有坑，生命周期缺失该fail-fast，静默失败上线后最难查——这次顺手把它改成抛异常吧。

先搜一下插件目录，八成是路径跟命名空间对不上。Linux 大小写敏感，`user_profile` 要是写成 `User_Profile` 就 class_exists 返回 false 了。查三步：文件是否真落在 Plugin\user_profile\Plugin.php、composer dump-autoload 刷没刷、升级是不是只覆盖了一半文件。实在不行把旧版删干净重装，比 debug 快。

这事儿得当天闭环：class_exists为false说明升级后要么文件没落地，要么命名空间大小写对不上，最坑的是它静默跳过——等于上线了个假包还显示成功。先查三样：旧目录残留、autoload缓存、升级脚本是否真覆盖。生命周期加硬断言，加载不到直接抛异常

升级阻断，进度如实报：先冻结分支回滚到上一版可用包，别急着合主干。class_exists 为 false，八成是命名空间或自动加载映射没跟着改，规范 §11.34 的生命周期静默跳过就是这坑，表面"安装成功"实则全废。

落地三步：今天内出定位结论，明天上午提修复，回归用例补一条"安装后强校验类是否存在"。任务我挂到看板，责任人@你，风险提前暴露，别让静默跳过混到上线。

class_exists 为 false 八成是 autoload 没热更：先 `composer dump-autoload -o` 再 `opcache_reset()`，顺手 grep 一下 `Plugin.php` 的真实路径和 PSR-4 前缀是否对得上，Linux 大小写敏感最容易翻车。前端这边插件静态资源记得带 hash 或 `?v=` 版本戳，不然升级完浏览器还啃旧 JS，跟没升一个样，哈哈。

这BUG我登记P1，先别急着动手改。给我三样：升级前版本号、升级包构建时间、复现步骤，缺一样我没法排期。class_exists返false，多半是autoload或目录结构没打进包，让开发本地复现后估个时间——别拍脑袋说

命名空间大小写对不上呗，升级脚本把目录写成 `user_profile` 了，PSR-4 映射的是 `UserProfile`，Linux 下直接凉。查三处：插件根目录名、composer.json 的 autoload.psr-4、升级后有没有跑 dump-autoload。还有插件缓存文件没清，老 manifest 还指着旧路径。顺带说一句，类找不到就该直接抛异常，别静默跳过生命周期，这种"差不多就行"的错误处理坑死人。

先在容器里复现，别动生产。这报错八成是 opcache 或 composer autoload 没刷新——升级后 php-fpm 没 reload，旧映射还在，class_exists 自然 false。查：`docker exec -it php php -r "var_dump(class_exists(...))"`，再确认插件目录 web 用户可读、`composer dump-autoload` 跑过没。规范 §11.34 那种静默跳过最坑，等于生命周期钩子被绕过，权限校验可能一起飞了。挂载只读、降权跑，别 root 起 php-fpm，先隔离了再说。

`class_exists` 为 false，八成是升级后命名空间或目录结构动了，autoload 没跟上。先跑 baseline：`composer dump-autoload`，再 `ls` 下 Plugin 目录是不是被挪进 src/ 或者大小写改了。§11.34 那个静默跳过就是偷懒