插件路由未生效的根本原因是未被框架加载或加载顺序被主应用路由覆盖；需确保插件位于app/plugin/下、含route/app.php文件，并通过配置plugins数组、Route::import()或事件监听三种方式启用，同时避免通配符路由拦截、确认加载路径及控制器命名空间正确。
ThinkPHP插件路由配置全解析【新手必读】：你刚安装完一个插件（比如支付插件、短信插件或CMS扩展），发现访问 /plugin/sms/send 报404，控制器方法明明写了却进不去——根本原因不是代码写错，而是插件自带的路由规则压根没被框架加载，或者加载顺序被主应用路由吞掉了。
确认插件路由是否被识别
打开命令行，执行 php think route:list，观察输出列表里是否出现插件定义的路由路径。如果完全看不到插件相关路径，说明插件路由文件根本没被扫描到。
【关键前提】 插件目录必须位于 app/plugin/ 下，且插件名与目录名严格一致（如 app/plugin/sms/），否则框架无法自动定位其路由文件。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
检查插件内部是否存在 route/app.php 文件。ThinkPHP 6+ 只认这个固定路径，不支持 route.php 或其他命名。若只有 config/route.php，需手动迁移规则到 route/app.php。
立即学习“PHP免费学习笔记（深入）”；
启用插件路由的三种方式
方法一：全局开启插件路由自动加载（推荐）
在项目根目录的 config/app.php 中，找到 'plugins' => [] 配置项，改为：
'plugins' => ['sms', 'pay'],
这会强制框架在启动时加载指定插件目录下的 route/app.php。注意插件名必须小写、无空格、与目录名完全一致。
方法二：手动注册插件路由（适合调试）
在主应用的 route/app.php 开头添加：
use think\facade\Route;<br>
Route::import('plugin.sms.route.app');<br>
Route::import('plugin.pay.route.app');Route::import() 的参数是插件内路由文件相对于 app/ 目录的路径，用点号分隔，且不带 .php 后缀。
方法三：通过事件监听动态加载（高级场景）
在 app/event.php 中注册 AppInit 事件回调：
return [<br>
'AppInit' => [<br>
function () {<br>
if (is_dir(app_path() . 'plugin/sms/')) {<br>
\think\facade\Route::import('plugin.sms.route.app');<br>
}<br>
}<br>
]<br>
];
解决插件路由冲突的实操步骤
第一步：确认主应用路由未拦截插件路径
检查主应用 route/app.php 中是否存在通配符路由，例如 Route::rule(':any', 'index/Index/index');。这类规则会匹配所有未定义路径，直接吞掉插件请求，必须删掉或加前置条件限制。
第二步：验证插件路由是否在主路由之前加载
执行 php think route:list --debug，查看每条路由的 file 字段。插件路由应显示为 app/plugin/sms/route/app.php，而非 app/route/app.php。若显示后者，说明插件路由被合并进了主路由文件，实际并未独立加载。
第三步：强制插件路由优先级
在插件自己的 route/app.php 开头插入一行：Route::setDomain(''); // 清除域名绑定，避免被子域名路由组覆盖
ThinkPHP 默认按文件加载顺序匹配路由，但若主应用用了 Route::domain() 分组，插件路由会被排除在外，必须显式解除绑定。
第四步：检查插件控制器命名空间
插件控制器类必须声明为 namespace app\plugin\sms\controller;，且路由地址中要完整写出该命名空间，例如：Route::get('sms/send', 'app\plugin\sms\controller\Sms@send');
漏写 app\plugin\sms\ 前缀会导致自动解析失败，报 Class not found 错误。
