在 Laravel 8 特征测试中，WithoutMiddleware 特性会禁用所有中间件（包括负责路由模型绑定的 SubstituteBindings），导致控制器接收空/新实例而非预期模型——移除该 trait 或显式启用绑定中间件即可解决。
在 laravel 8 特征测试中，路由模型绑定失效的典型表现是：测试中通过 `route()` 传入已创建的模型实例，但控制器方法接收到的却是全新、未填充的 eloquent 实例（如 `purchase::__construct()` 空对象），而非数据库中对应记录的模型。这并非路由或控制器逻辑错误，而是测试环境配置干扰了 laravel 的核心绑定机制。
? 问题本质：模型绑定依赖中间件，而 WithoutMiddleware 将其彻底移除
Laravel 的隐式路由模型绑定（Implicit Route Model Binding）并非框架底层自动行为，而是由中间件 Illuminate\Routing\Middleware\SubstituteBindings 实现的。该中间件在请求生命周期中解析路由参数（如 {purchase}），根据类型提示（Purchase $purchase）自动执行 Purchase::resolveRouteBinding($value) 查询并注入实例。
但在你的 PurchaseTest.php 中使用了：
use WithoutMiddleware;
该 trait 会全局禁用所有中间件（包括 SubstituteBindings），导致：
Laravel Cloud（cloud.laravel.com）。此技能用于处理所有 Laravel Cloud 请求，包括搜索和读取数据。只要任务涉及 Laravel Cloud，即使用此技能。
- 路由参数
{purchase}仍被解析为 ID 字符串（如"1"）； - 但中间件未运行 → 模型未查询 → 控制器收到的是
new Purchase（空模型）； - 浏览器访问正常，是因为 Web 请求走完整中间件栈，绑定得以执行。
✅ 验证方式：在测试中
dd($response->baseResponse->headers->get('X-RateLimit-Remaining'))可确认中间件是否生效；或直接检查$purchase->exists—— 若为false，即说明绑定失败。
✅ 正确解决方案（推荐两种）
方案一：移除 WithoutMiddleware（最简洁可靠）
class PurchaseTest extends TestCase
{
use RefreshDatabase; // ✅ 保留，确保测试数据隔离
// ❌ 移除 use WithoutMiddleware;
public function test_purchase_can_be_updated()
{
$purchase = Purchase::create([
'item' => 'tariqs item',
'support' => '2022-09-09',
'status' => PurchaseStatus::ACTIVE,
'purchase_code' => '1234',
'username' => 'tariq',
'user_id' => 1,
]);
$response = $this->patch(
route('admin.purchases.update', ['purchase' => $purchase]), // 显式键名更清晰
[
'item' => 'tariqs item edit',
'support' => '2022-09-09',
'status' => PurchaseStatus::ACTIVE,
'purchase_code' => '1234',
'username' => 'tariq',
]
);
$response->assertStatus(200);
$this->assertTrue($purchase->fresh()->item === 'tariqs item edit');
}
}
方案二：若必须禁用其他中间件，仅保留绑定中间件
use Illuminate\Foundation\Testing\RefreshDatabase;
// use WithoutMiddleware; // ❌ 不再使用
class PurchaseTest extends TestCase
{
use RefreshDatabase;
protected function setUp(): void
{
parent::setUp();
// 手动注册绑定中间件（仅需此一个）
$this->withoutMiddleware([
\App\Http\Middleware\VerifyCsrfToken::class, // 示例：仅禁用 CSRF
// 其他需跳过的中间件...
]);
// ✅ SubstituteBindings 保持启用（默认不在此列表中）
}
}
⚠️ 注意事项与最佳实践
-
永远避免在涉及模型绑定的测试中使用
WithoutMiddleware：它破坏了 Laravel 的关键基础设施，不仅影响绑定，还可能绕过认证、权限、日志等核心逻辑。 -
路由参数命名必须严格匹配：确保
route('admin.purchases.update', ['purchase' => $purchase])中的键'purchase'与路由定义/{purchase}/update及控制器参数Purchase $purchase的变量名一致（大小写敏感）。 -
测试前验证模型存在：添加断言确保
$purchase->exists === true，排除工厂创建失败。 -
调试技巧：在控制器中
dd(request()->route()->parameters())查看实际解析的参数值，确认是否传入了正确 ID。
? 总结
路由模型绑定不是“魔法”，而是中间件驱动的显式流程。特征测试中 WithoutMiddleware 是一把双刃剑——它简化了部分场景，却会无声地切断框架的关键能力。真正的测试健壮性，来自尊重框架设计契约，而非规避它。 移除该 trait，让测试运行在接近生产的真实中间件环境中，才是 Laravel 测试的最佳实践。
