Digital Ocean应用平台部署Laravel Filament遇路径问题求助

核心问题分析 #

仅设置APP_URL不足以让Filament完全适配子路由环境，因为Filament的静态资源路径生成、路由注册、重定向逻辑等都需要更细致的配置，并非单一环境变量就能覆盖。

具体修复步骤 #

1. 为Filament面板指定基础路径 #

修改app/Providers/Filament/AdminPanelProvider.php，直接在面板配置中设置子路径：

use Filament\Panel;

public function panel(Panel $panel): Panel
{
    return $panel
        ->default()
        ->path('app/admin') // 明确指定面板的基础访问路径
        // 保留其他原有配置（如认证、资源注册等）
        ->login()
        ->resources([
            // ...
        ]);
}

这个配置会让Filament自动将所有面板路由前缀设为/app/admin，包括登录页、资源页等。

2. 修正静态资源的URL生成逻辑 #

在.env文件中添加ASSET_URL环境变量，确保Filament加载CSS、JS等静态资源时使用正确的子路径：

APP_URL=https://example-site.com/app
ASSET_URL=https://example-site.com/app

避免使用${APP_URL}/app这种嵌套变量，直接写入完整URL更可靠，防止解析错误。

3. 调整路由注册规则（可选） #

如果面板路径配置后仍有路由冲突，可手动覆盖Filament的路由注册逻辑，在routes/web.php中添加：

use Filament\Facades\Filament;
use Illuminate\Support\Facades\Route;

Filament::serving(function () {
    Filament::registerRoutes(function () {
        Route::prefix('app')
            ->group(base_path('vendor/filament/filament/routes/web.php'));
    });
});

这会强制Filament的所有路由都挂载在/app前缀下。

4. 验证Digital Ocean路由映射 #

确保DO应用平台的路由规则正确：

• 根路径/*指向Next.js应用
• /app/*指向Laravel应用
  同时要保证Laravel容器能正确接收/app开头的请求，DO平台的路由转发不会丢失路径前缀。

替代方案评估 #

如果上述配置仍无法解决问题，你考虑的两种方案都是可行的：

• Laravel移至根目录，前端部署到Vercel：这是最省心的方案，Vercel对Next.js的优化更到位，Laravel在根目录下无需适配子路由，Filament能正常工作，只需在前端配置API请求地址指向Laravel域名即可。
• 调整路由分配：让前端使用/frontend/*子路由，Laravel占据根目录，彻底避免子路由适配问题，配置成本更低。

内容的提问来源于stack exchange，提问作者macke89