Laravel路由测试怎么编写_Laravel路由测试的编写技巧【技巧】

Lara vel 路由测试，说难不难，说简单也真有不少暗坑。很多同学拿着文档一顿猛写，get() 一执行，满眼尽是 404、419、500，心态直接崩掉。问题到底出在哪？说白了，Lara vel 的路由测试走的是一条完整的 HTTP 请求生命周期，它不是简简单单调一下控制器方法就完事的。中间件、CSRF 验证、甚至 Session 状态，哪一个环节没对齐，报错就来了。

先给大家列几个最常见的坑：

• 404 报错：大概率是路由压根没注册，或者命名空间写偏了。
• 419 报错：CSRF token 缺失，挡在门外了。
• 500 报错：中间件抛了异常，或者是引用的配置文件没加载。

搞定这些，有几个基本的规矩得守住：

• 测试文件必须放在 tests/Feature/ 目录下，并且测试类要继承 Tests\TestCase。
• 发请求要用框架封装好的方法，比如 $this->get('/xxx') 或 $this->post('/xxx')，千万别为了图省事去用 app()->call()，那玩意儿不走完整流程。
• 对于 POST、PUT、PATCH 这类会修改数据的请求，要么临时关掉 CSRF 中间件（withoutMiddleware()），要么老老实实在请求里带上 _token。
• 如果路由里有参数，比如 /user/{id}，用 route() 辅助函数来生成路径（例如 $this->get(route('user.show', ['id' => 1]))），比硬编码 'id=1' 安全得多，至少能防止路由名称拼写错误。

如何让路由测试覆盖重定向、中间件和命名路由？

命名路由和中间件是 Lara vel 路由的灵魂，但测试时容易只盯着“能不能通”，忽略了行为逻辑。举个例子，auth 中间件到底有没有把人踢到登录页？route('login') 返回的是不是 302？where 约束能不能拦住非法参数？这些问题，单测一个状态码是看不出结果的。

• 测重定向：用 $this->get('/admin')->assertRedirect(route('login')) 来断言，只测 302 是不够的，得确认它跳到了正确的地方。
• 测中间件效果：做一个“未登录”的请求，期望它返回 302；再用 actingAs() 模拟登录后，才去断言 200。这样就把中间件的拦截逻辑测透了。
• 测命名路由是否存在：可以在测试类的 setUp() 方法里先用 Route::has('profile.edit') 检查一次，确保路由定义没写错，免得后面因为一个拼写错误导致一大片测试挂掉。
• 测 where 约束：传一个非法参数进去，比如 $this->get('/post/abc')，期望返回 404；传一个合法整数 /post/123，才能正常进控制器。这样才能确保参数校验生效。

TestCase::withoutExceptionHandling() 该不该开？

这个工具，开了能让你看到完整的报错堆栈，调试问题一针见血；关了的话，所有异常都会被框架吞掉，只给你留一个模糊的 500。但盲目开启它，副作用也很大——线上用户可看不到异常详情。说白了，它是个调试利器，不是常规武器。

• 调试阶段当然可以临时用，比如加上 $this->withoutExceptionHandling()，顺藤摸瓜找到 Controller 或 Model 里的报错根源。
• 但在 CI 环境或正式的测试套件里，必须关掉。否则一旦报错，堆栈里的敏感路径和配置信息就可能被你无意中泄露出去。
• 更稳妥、更专业的做法，是用 expectException() 来显式断言预期的异常。比如测试权限不足时，就断言会抛出 AuthorizationException。
• 注意：一旦开启了 withoutExceptionHandling()，异常就不会被框架渲染成标准响应对象了，这时候 assertStatus() 可能会失效。所以最好只在单个 test 方法内部局部使用，用完就关。

测试 API 路由和 Web 路由混用时要注意什么？

Lara vel 默认把 api 和 web 的路由分在两个组里，中间件、Session、CSRF、跨域策略完全不一样。用 Web 路由那套测试方法去测 API 路由，大概率会栽在 StartSession 或 VerifyCsrfToken 这类中间件上。

• API 路由测试请统一使用 $this->json('GET', '/api/users') 方法，别用 $this->get()。
• Web 路由测试默认带 Session，而 API 路由测试默认是没有 Session 的。所以别指望在 API 测试里直接用 Auth::user()。
• 如果 API 需要认证，必须用 $this->actingAs($user, 'api') 来指定 guard，而不是用 withSession()。
• 最后检查一下 RouteServiceProvider 里的 mapApiRoutes() 方法有没有被正常调用，确保 routes/api.php 文件确实被加载了。

其实，路由测试最容易被忽略的，是「中间件的执行顺序」和「请求头环境」。比如，你要测试一个 JSON 接口，但忘记在请求头里设置 Accept: application/json，Lara vel 就可能把未认证用户重定向到 HTML 登录页面，而不是返回预期的 JSON 错误。又或者，你自定义了一个依赖 Request::ip() 的中间件，但在测试环境里没有 mock 这个值，导致测试结果永远不对。这些细节才是真正考验功力的地方。