Laravel 的 Route::inertia() 仅支持静态组件渲染，无法直接绑定控制器方法；若需动态数据，应改用 Route::get() 配合控制器中的 Inertia::render()，这是官方推荐且最清晰的实践方式。

laravel 的 `route::inertia()` 仅支持静态组件渲染，无法直接绑定控制器方法；若需动态数据，应改用 `route::get()` 配合控制器中的 `inertia::render()`，这是官方推荐且最清晰的实践方式。

在 Laravel 中，Route::inertia() 是一个便捷的路由宏，专为无服务端逻辑的纯前端页面设计——它底层调用 Inertia::render() 并自动返回响应，但不支持传入控制器回调或自动执行业务逻辑。因此，像 Route::inertia('/home', 'Home', [HomeController::class, 'index']) 这样的写法是无效的，Laravel 会抛出 BadMethodCallException 或静默忽略第三个参数。

✅ 正确做法：使用标准 Route::get() + 控制器显式调用 Inertia::render()

// routes/web.php
Route::get('/terms', [LegalPageController::class, 'index']);

// app/Http/Controllers/LegalPageController.php
<?php namespace App\Http\Controllers;

use App\Models\Terms;
use Illuminate\Http\Request;
use Inertia\Inertia;

class LegalPageController extends Controller
{
    public function index()
    {
        $record = Terms::firstOrFail(); // 或 ->first() + 空值处理

        return Inertia::render('Terms', [
            'record' => $record,
        ]);
    }
}

⚠️ 注意事项：

• 不要继承 Controller 类时重写父类同名方法（如示例中误写 class Controller extends Controller），这会导致循环继承错误；应使用具体命名（如 LegalPageController）。
• Inertia::render() 接收组件名和数据数组（推荐关联数组而非 compact()，更易维护、类型安全）。
• 若需复用渲染逻辑，可封装为 Trait 或基类方法，但路由仍须通过 Route::get() 显式绑定。

? 小技巧：为简化重复代码，可定义基类：

Laravel Creem Agent

Creem 支付商店助理 — 查询订阅、客户、交易、产品，执行心跳检查，管理本地 Laravel支付商店。

下载

// app/Http/Controllers/InertiaController.php
abstract class InertiaController extends Controller
{
    protected function inertia(string $component, array $props = []): \Inertia\Response
    {
        return Inertia::render($component, $props);
    }
}

然后控制器继承它：

class LegalPageController extends InertiaController
{
    public function index()
    {
        return $this->inertia('Terms', [
            'record' => Terms::firstOrFail(),
        ]);
    }
}

总结：Route::inertia() 是语法糖，适用于静态页；动态数据必须交由控制器处理——这是 Inertia 官方架构的设计原则，兼顾清晰性与可维护性。