在 Laravel 8 特征测试中，WithoutMiddleware 会禁用包括路由模型绑定中间件在内的所有中间件，导致控制器接收到空模型实例而非预期数据库记录——移除该 trait 或显式启用关键中间件即可修复。
在 laravel 8 特征测试中，路由模型绑定失效的典型表现是：测试中创建的 eloquent 模型（如 `$purchase`）无法通过隐式绑定注入控制器方法，控制器接收的是一个全新、未填充的模型实例，而非数据库中实际存在的记录；而相同路由在浏览器中访问却完全正常。根本原因在于 laravel 的隐式路由模型绑定依赖于内置中间件 `substitutebindings`，而 `withoutmiddleware` trait 会全局禁用所有中间件，直接切断绑定流程。
? 问题定位：模型绑定本质是中间件行为
Laravel 的隐式路由模型绑定（如 Purchase $purchase）并非框架底层自动解析机制，而是由 Illuminate\Routing\Middleware\SubstituteBindings 中间件在请求生命周期中完成的。该中间件负责：
- 解析路由参数（如
{purchase}）； - 根据参数值（如 ID）调用
Purchase::resolveRouteBinding($value)； - 将查得的模型实例替换原始参数，注入控制器方法。
因此，模型绑定是一个中间件驱动的功能，而非语法糖或反射魔术。
❌ 错误实践：滥用 WithoutMiddleware
在您的 PurchaseTest.php 中，use WithoutMiddleware; 是问题根源：
class PurchaseTest extends TestCase
{
use RefreshDatabase;
use WithoutMiddleware; // ⚠️ 危险！它会禁用 SubstituteBindings 中间件
}一旦启用 WithoutMiddleware，整个中间件栈（包括 SubstituteBindings）被跳过，Laravel 不再尝试查找 Purchase 模型，而是直接将路由参数字符串（如 "1"）或空值传递给类型提示变量——Eloquent 会因未传入主键而实例化一个空模型（即 new Purchase），这正是 dd($purchase) 显示“新实例”的原因。
Laravel Cloud（cloud.laravel.com）。此技能用于处理所有 Laravel Cloud 请求，包括搜索和读取数据。只要任务涉及 Laravel Cloud，即使用此技能。
✅ 验证方式：在测试中临时注释
use WithoutMiddleware;，运行测试，绑定将立即恢复正常。
✅ 正确解决方案
方案一：移除 WithoutMiddleware（推荐）
绝大多数特征测试无需禁用全部中间件。RefreshDatabase 已确保数据库隔离，而认证、权限等中间件反而能更真实地模拟生产环境。修改如下：
class PurchaseTest extends TestCase
{
use RefreshDatabase; // ✅ 保留，保障数据清洁
// ❌ 移除 use WithoutMiddleware;
public function test_purchase_can_be_updated()
{
$purchase = Purchase::factory()->create([ // 建议改用工厂提高可读性
'item' => 'tariqs item',
'support' => '2022-09-09',
'status' => PurchaseStatus::ACTIVE,
'purchase_code' => '1234',
'username' => 'tariq',
'user_id' => 1,
]);
$response = $this->actingAs($this->adminUser()) // 如需认证，显式登录
->patch(route('admin.purchases.update', $purchase), [
'item' => 'tariqs item edit',
'support' => '2022-09-09',
'status' => PurchaseStatus::ACTIVE,
'purchase_code' => '1234',
'username' => 'tariq',
]);
$response->assertStatus(200);
$this->assertDatabaseHas('purchases', [
'id' => $purchase->id,
'item' => 'tariqs item edit',
]);
}
}方案二：仅禁用特定中间件（按需选择）
若测试确实需绕过某些中间件（如 VerifyCsrfToken），应精准排除，而非全量禁用：
use Illuminate\Foundation\Testing\WithoutMiddleware;
// 在测试类顶部不使用 use WithoutMiddleware;
// 而是在具体测试方法中局部禁用：
public function test_purchase_can_be_updated()
{
$this->withoutMiddleware([
\App\Http\Middleware\VerifyCsrfToken::class,
// ✅ 其他非核心中间件...
// ❌ 不包含 \Illuminate\Routing\Middleware\SubstituteBindings::class
]);
// ...测试逻辑
}? 补充注意事项
-
路由参数命名必须一致：确保
route('admin.purchases.update', $purchase)中传递的是模型实例（Laravel 自动提取主键），且路由定义/{purchase}/update中的参数名purchase与控制器方法签名Purchase $purchase的变量名严格匹配（区分大小写）。 -
避免手动构造 URL：使用
route()辅助函数生成 URL，而非url('admin/purchases/1/update')，以防参数未正确解析。 -
调试技巧：在测试中添加
dump($purchase->id);和dump(route('admin.purchases.update', $purchase));可快速验证参数是否正确注入路由。
✅ 总结
| 问题现象 | 根本原因 | 解决动作 |
|---|---|---|
控制器接收空 Purchase 实例 |
WithoutMiddleware 禁用了 SubstituteBindings 中间件 |
移除该 trait，或仅禁用非关键中间件 |
路由模型绑定不是“魔法”，而是 Laravel 中间件生态的关键一环。尊重其设计契约——不随意剥离中间件栈——是编写可靠特征测试的前提。
