ThinkPHP自动加载机制升级修复_命名空间与目录映射方案-ThinkPHP-PHP中文网

vendor:publish后类找不到，本质是psr-4映射未写入composer.json autoload段；需检查扩展包是否声明autoload，未声明则手动添加并运行composer dump-autoload -o。

thinkphp自动加载机制升级修复_命名空间与目录映射方案

为什么 `vendor:publish` 后类找不到？

ThinkPHP 6+ 默认关闭自动发现，composer dump-autoload 不再触发框架级命名空间映射。你执行了 php think vendor:publish，但新扩展的类仍报 Class not found，本质是 PSR-4 映射没进 composer.json 的 autoload 段。

检查扩展包的 composer.json 是否声明了 autoload（尤其是 psr-4），没有就手动加
若扩展包未声明，需在项目根目录 composer.json 的 autoload 下追加：
```
"psr-4": {
    "extension\": "extend/extension/src/"
}
```
改完必须运行 composer dump-autoload -o（加 -o 强制优化，否则开发环境可能不生效）
注意路径末尾斜杠：ThinkPHP 对目录映射敏感，"app\" 和 "app\"（Windows 反斜杠）在某些 Composer 版本下会失败

`app_namespace` 配置失效的常见原因

你在 config/app.php 改了 app_namespace 为 "app_v2"，但控制器仍从 appcontroller 加载——这不是配置没读取，而是 app_namespace 仅影响默认应用目录的根命名空间，不接管所有自动加载。

app_namespace 只作用于 app/ 目录下的类，对 extend/、runtime/ 或自定义路径无效
路由绑定控制器时，如果 URL 路径含模块名（如 /admin/index），实际加载的是 appdmincontrollerIndex，此时 app_namespace 会被忽略，模块名直接拼接进命名空间
若用 Loader::addNamespace() 手动注册，优先级高于 app_namespace，且不会被配置文件覆盖
调试技巧：在控制器里打日志 echo get_class($this);，确认实际加载的类名，再反推命名空间是否匹配目录结构

自定义目录映射时 `Loader::addPsr4()` 和 Composer 的冲突点

你调用 Loader::addPsr4('common\', APP_PATH . 'common/') 想让 common 目录走独立命名空间，结果和 Composer 自动加载打架，类偶尔加载成功、偶尔报错。

ThinkPHP 的 Loader 是运行时映射，Composer 是静态生成的 vendor/composer/autoload_psr4.php，两者共存时以先注册者为准
推荐只用一种方式：要么全交由 Composer 管理（删掉所有 Loader::addPsr4() 调用），要么彻底禁用 Composer 的 PSR-4（把 composer.json 中对应段清空并重跑 dump-autoload）
若必须混用，确保 Loader::addPsr4() 在 thinkphp/base.php 初始化之后、应用启动之前调用（比如放在 public/index.php 的 require 后立即执行）
注意大小写：Windows 下 Common 目录和 common\ 命名空间能通，Linux 会严格区分，上线前务必在目标环境验证

升级到 ThinkPHP 7 后 `__autoload` 回调被跳过

你写了全局 __autoload 函数想兜底加载某些旧类，但在 TP7 下完全不触发——因为 TP7 默认启用 spl_autoload_register 并设为 prepend 模式，原生 __autoload 已被绕过。

TP7 的自动加载器链中，thinkinitializerLoader 注册在最前，它内部已处理全部 PSR-4 + 类映射，没匹配到才轮到下一个，而 __autoload 不在链里
正确做法是继承 thinkLoader，重写 loadClass() 方法，在父类返回 false 后插入你的逻辑，再调用 spl_autoload_functions() 获取其他注册器手动触发
更轻量方案：在 app/common.php 里用 spl_autoload_register(function ($class) { ... }, true, true)，第三个参数 true 表示 prepend，第二个 true 表示启用异常抛出便于调试
别依赖 __autoload：TP6 起已标记为废弃，TP7 彻底移除文档支持，线上环境可能因 PHP 版本差异直接失效

命名空间映射真正难的不是写对路径，而是搞清哪一层在起作用：Composer 的静态映射、Loader 的运行时注册、路由解析时的动态拼接，三者嵌套时一个斜杠或一次重复注册就能让类加载静默失败。上线前用 composer show --platform 确认 autoload 配置已生效，再拿 get_declared_classes() 快速扫一眼目标类是否在列表里。