Laravel带auth.basic中间件的API路由测试异常问题排查

我最近碰到一个头疼的问题：Laravel项目里有个带auth.basic中间件的API路由，控制器要用到已认证用户的ID。在Postman里调用完全正常——用户名密码错了返回401，正确的话能正常获取用户信息。但在继承DuskTestCase的APITest里，认证彻底失效：用户信息错误时返回500而非401，就算用正确的账号，auth()也返回null，直接触发错误。

相关代码片段 #

api.php路由配置 #

Route::get('/xxxxxx/xxxxxx/xxxxxxx', 'xxxxx@xxxx')->middleware('auth.basic');

APITest测试代码 #

$response = $this->withHeaders(['Authorization' => 'Basic '. base64_encode("{$username}:{$password}")])->get("/xxxxxx/xxxxxx/xxxxxxx");

问题根源与解决方案 #

核心问题出在你选错了测试基类：DuskTestCase是专门为浏览器端UI测试设计的，它的底层是通过ChromeDriver等浏览器驱动模拟真实浏览器行为，和普通API测试的请求处理机制完全不同。auth.basic中间件在Dusk的请求环境下无法正确解析Authorization头，导致认证逻辑异常。

解决方法很简单：

• 把你的APITest类从继承DuskTestCase改成继承项目里的基础TestCase（也就是tests/TestCase.php，这个类是Laravel默认提供的用于API/单元测试的基类）
• 如果确实需要在Dusk测试中调用API，建议用Dusk的script方法发送AJAX请求，或者单独为API测试创建基于TestCase的测试文件——毕竟Dusk的定位是UI自动化测试，API测试用基础测试类才是正确的姿势。

另外可以额外检查一下：如果坚持用Dusk测试API，确认你的API路由没有被CSRF验证拦截（虽然API路由默认排除，但Dusk环境可能会有全局中间件干扰），不过最根本的还是换测试基类，这能直接解决你的问题。

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