ThinkPHP 6 开启多应用模式后默认应用访问404问题解决

一、问题/场景描述

在 ThinkPHP 6 项目中，开发者通过官方命令或手动配置开启了多应用模式。配置完成后，访问项目根路径（例如 http://yourdomain.com/）时，预期应该访问到默认应用（通常是 index 应用）的首页，但实际却返回了 404 错误页面。而直接访问其他已创建的应用路径则可能正常。

二、原因分析

出现此问题的主要原因在于路由配置与重写规则。开启多应用模式后，ThinkPHP 的路由解析逻辑发生了变化。默认情况下，框架可能无法正确地将根路径的请求映射到默认应用的控制器。这通常与应用的入口文件 index.php 中的路径定义、项目根目录下的 .htaccess（Apache）或 Nginx 配置中的重写规则，以及多应用模式下的路由配置文件（如 config/app.php 中的 default_app 设置）有关。需要逐一检查并修正这些配置点。

三、详细解决步骤

请按照以下步骤检查和修改配置，以解决默认应用访问 404 的问题。

步骤1：检查并设置默认应用

首先，确认在全局配置文件中已经正确设置了默认应用。打开 config/app.php 文件，检查 default_app 配置项。

<?php
// config/app.php
return [
    // 其他配置...
    // 确保 default_app 设置为你的默认应用名称，例如 'index'
    'default_app'      => 'index',
    // 其他配置...
];

步骤2：检查入口文件路径

检查项目根目录下的入口文件 public/index.php，确保应用目录的路径定义正确。关键是要正确定义 $appPath。

<?php
// public/index.php
namespace think;

// 定义应用目录
// 注意：这里应该是相对于入口文件的路径，指向 app 目录
$appPath = dirname(__DIR__) . '/app/';

require __DIR__ . '/../vendor/autoload.php';

// 执行HTTP应用并响应
$http = (new App())->http;

// 将应用目录路径传入 run 方法
$response = $http->name('')->setAppPath($appPath)->run();
$response->send();
$http->end($response);

步骤3：配置URL重写（针对Apache）

如果使用 Apache 服务器，请检查 public/.htaccess 文件，确保重写规则正确，将所有请求导向入口文件。

# public/.htaccess
<IfModule mod_rewrite.c>
  Options +FollowSymlinks -Multiviews
  RewriteEngine On

  RewriteCond %{REQUEST_FILENAME} !-d
  RewriteCond %{REQUEST_FILENAME} !-f
  # 确保这里重写到 index.php，注意路径
  RewriteRule ^(.*)$ index.php [L,E=PATH_INFO:$1]
</IfModule>

步骤4：配置URL重写（针对Nginx）

如果使用 Nginx 服务器，需要在站点配置中添加 try_files 指令，确保请求被正确路由到 index.php。

server {
    listen 80;
    server_name yourdomain.com;
    root /path/to/your/project/public;
    index index.php index.html;

    location / {
        # 核心：尝试访问文件或目录，否则重写到 index.php
        try_files $uri $uri/ /index.php$is_args$args;
    }

    location ~ .php$ {
        fastcgi_pass   127.0.0.1:9000;
        fastcgi_index  index.php;
        fastcgi_param  SCRIPT_FILENAME  $document_root$fastcgi_script_name;
        include        fastcgi_params;
    }
}

步骤5：清除路由缓存并测试

完成以上配置修改后，务必清除框架的运行时缓存，以确保新配置生效。

# 在项目根目录下执行
php think clear

最后，重启你的 Web 服务器（如 Nginx 或 Apache），然后再次访问项目根路径，检查 404 错误是否已解决。

四、注意事项

在修改配置时，请注意配置文件的路径和权限。修改 Nginx 或 Apache 配置后，必须重启服务才能使更改生效。如果问题依旧，请检查默认应用（如 index 应用）的控制器和路由文件是否存在且命名正确，并确保服务器已开启 URL 重写模块（如 Apache 的 mod_rewrite）。

五、适用环境

本解决方案适用于已成功安装并开启多应用模式的 ThinkPHP 6.0 及以上版本的项目。