本文旨在解决Symfony框架中，在使用子域名进行路由时出现404错误的问题。通过分析可能的原因，并结合示例代码，提供了一套完整的解决方案，包括配置.htaccess文件以确保请求正确重定向到public目录，以及调整EasyAdmin的配置以避免权限问题。
在使用Symfony框架（例如5.3版本）开发Web应用时，可能会遇到子域名路由配置后出现404错误的情况。尤其是在使用类似EasyAdmin这样的第三方包时，这个问题可能会更加复杂。本文将深入探讨这个问题，并提供详细的解决方案。
问题分析
当你在本地开发环境中（例如使用symfony server:start）路由工作正常，但在服务器上使用子域名（例如https://subdomain.domain.com/admin）访问时出现404错误，通常意味着服务器没有正确地将请求路由到Symfony应用的public目录。即使php bin/console debug:router命令显示路由配置正确，也可能存在这个问题。
解决方案
解决这个问题的关键在于确保所有请求都被正确地重定向到public目录，并且EasyAdmin的权限配置没有阻止对特定路由的访问。
1. 配置 .htaccess 文件
在网站根目录（/）下创建或修改 .htaccess 文件，添加以下内容：
RewriteEngine On
RewriteBase /
RewriteCond %{THE_REQUEST} /public/([^\s?]*) [NC]
RewriteRule ^ %1 [L,NE,R=302]
RewriteRule ^(.*)$ public/index.php?$1 [L,QSA]这段代码的作用是将包含/public/的请求重定向到根目录，并将所有其他请求转发到public/index.php，从而由Symfony应用处理。
然后在 public 目录下也创建或修改 .htaccess 文件，添加以下内容：
RewriteEngine On
RewriteBase /
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ index.php?$1 [L,QSA]这段代码的作用是当请求的文件或目录不存在时，将请求转发到 index.php，由Symfony应用处理。
注意事项：
- 确保你的服务器启用了 mod_rewrite 模块。
- .htaccess 文件的语法非常严格，任何错误都可能导致服务器错误。仔细检查代码，确保没有拼写错误或语法错误。
- RewriteBase 指令应该设置为你的应用的根目录。如果你的应用位于子目录中，需要相应地修改 RewriteBase 的值。
2. 解决EasyAdmin权限问题
在修改了 .htaccess 文件后，你可能会遇到访问 /admin 路由时出现 "Forbidden" 错误。这通常是由于EasyAdmin的URL签名机制导致的。
要解决这个问题，你需要在 DashboardController 的 configureDashboard() 方法中禁用URL签名：
namespace App\Controller\Admin;
use EasyCorp\Bundle\EasyAdminBundle\Config\Dashboard;
use EasyCorp\Bundle\EasyAdminBundle\Controller\AbstractDashboardController;
use Symfony\Component\HttpFoundation\Response;
use Symfony\Component\Routing\Annotation\Route;
use EasyCorp\Bundle\EasyAdminBundle\Router\AdminUrlGenerator;
class DashboardController extends AbstractDashboardController
{
/**
* @Route("/admin", name="admin")
*/
public function index(): Response
{
$routeBuilder = $this->get(AdminUrlGenerator::class);
$url = $routeBuilder->setController(BookCrudController::class)->generateUrl();
return $this->redirect($url);
}
public function configureDashboard(): Dashboard
{
return Dashboard::new()
->disableUrlSignatures()
// ... 其他配置
;
}
// ... 其他方法
}通过调用 ->disableUrlSignatures() 方法，你禁用了EasyAdmin的URL签名机制，从而允许访问 /admin 路由。
总结
解决Symfony子域名路由404错误的关键在于确保服务器正确地将请求重定向到 public 目录，并正确配置EasyAdmin的权限。通过配置 .htaccess 文件和禁用URL签名，可以有效地解决这个问题。
其他注意事项：
- 检查你的服务器配置，确保子域名已经正确地指向了你的Symfony应用的根目录。
- 清除Symfony的缓存，以确保新的路由配置生效。可以使用 php bin/console cache:clear 命令清除缓存。
- 如果问题仍然存在，检查你的Symfony应用的日志文件，以获取更多错误信息。
