TP6 多应用模式出现路由定义错误，通常是因为全局路由未绑定到具体应用或强制路由模式下缺少应用内路由文件。最推荐的处理方向是检查是否安装多应用扩展，并在每个应用目录下单独建立 route 文件夹定义路由，避免依赖根目录的全局路由配置。

命令速用版

若未安装多应用扩展，需在项目根目录执行以下命令安装依赖，随后构建应用目录结构。

composer require topthink/think-multi-app
php think build index

若需隐藏入口文件，需在 public 目录下配置伪静态，Apache 环境修改.htaccess 文件，Nginx 环境配置 rewrite 规则将请求指向 index.php。

为什么会这样

TP6 多应用模式启用了应用隔离机制，导致全局路由配置无法自动加载到子应用中。开启强制路由模式后，系统要求所有访问必须匹配已定义的路由规则，而多应用架构下路由文件需位于应用目录内而非根目录。若仍使用单应用模式的路由习惯，将直接触发路由未定义异常。

分步处理

步骤一：检查环境与扩展

确认项目已安装多应用扩展包，检查 composer.json 中是否存在 topthink/think-multi-app。若 app 目录下存在 controller 文件夹，需将其删除或移走，系统通过该目录是否存在来判断单应用或多应用模式。

步骤二：配置应用路由目录

在每个应用目录下单独建立 route 文件夹，例如 app/index/route。在该文件夹内新建路由文件（如 app.php），命名空间需对应应用路径，例如 namespace app\index\route;。在此文件中定义当前应用的具体路由规则，避免使用根目录 route 下的配置。

步骤三：配置入口与绑定

若希望使用不同入口文件访问不同应用，可在 public 目录下复制 index.php 为 admin.php，修改代码中$http->name('admin') 为对应应用名。若使用域名绑定，需在 config/app.php 中配置 domain_bind 参数，将特定域名指向具体应用。

步骤四：调整强制路由配置

检查 config/app.php 中的 url_route_must 配置。若开启强制路由，必须确保所有访问路径都有对应路由定义。若暂不需要强制路由，可关闭该选项以允许直接访问控制器方法。

怎么验证是否生效

开启应用调试模式，在浏览器中访问 http://域名/index.php/应用名/控制器/操作。若配置正确，页面正常加载且不报路由错误。若开启伪静态，尝试去掉 index.php 访问，确认 rewrite 规则生效。查看 runtime 日志文件，确认无 RouteNotFoundException 异常抛出。

常见坑

多应用模式下，根目录 route/app.php 定义的路由在强制路由模式中会失效，必须到应用目录下重建。访问接口时若未带应用模块名称，系统可能默认指向 index 应用导致匹配失败。若使用子域名绑定，需确保 DNS 解析正确且 config/app.php 中 domain_bind 配置无误。部分旧项目迁移时，若未删除 app/controller 目录，系统可能仍按单应用模式运行导致配置不生效。

常见问题

开启强制路由后报当前访问路由未定义或不匹配怎么办？

需在对应应用目录下新建 route 文件夹并定义路由，或关闭强制路由配置。

多应用模式下全局路由为什么不起作用？

多应用模式隔离了配置，全局路由不会自动加载到子应用，需在应用内单独配置。

如何在不带应用名的 URL 下访问特定应用？

可通过配置 domain_bind 绑定域名，或在 public 下创建独立入口文件如 admin.php 指定应用名。

404 错误但路由已定义是怎么回事？

检查伪静态配置是否正确，尝试在 URL 中加入 index.php 测试是否为重写规则问题。

参考来源

• TP6 多应用报错当前访问路由未定义或不匹配（2022 年 9 月 19 日收录）
• tp6 使用 lock_ThinkPHP6 多应用模式使用强制路由模式的坑（2020 年 12 月 28 日）
• thinkphp6 多应用下强制路由无效问题解决方法（2020 年 4 月 28 日发布）
• thinkphp6 多应用模式下访问路由显示路由不匹配的解决方法_thinkphp route not found-CSDN 博客（2021 年 3 月 8 日撰）
• TP6 多应用入口，路由及路由分组 不能访问问题 (三大问题详细交你处理)（2020 年 5 月 9 日资料）