Laravel5+jenssegers/agent在PHPUnit中无法获取User-Agent求助

这问题我之前踩过坑！核心原因其实很直白：PHPUnit 运行测试时发起的是模拟 HTTP 请求，默认不会自动携带 User-Agent 这类浏览器专属的请求头——毕竟它不是真实的浏览器访问，所以不管你用$request->header('user-agent')、$request->server('HTTP_USER_AGENT')还是直接读$_SERVER['HTTP_USER_AGENT']，自然都拿不到有效内容。

下面给你几个实用的解决办法：

1. 单测试用例手动添加 User-Agent 请求头 #

在具体的测试方法里，用 Laravel 测试套件提供的withHeaders方法，给模拟请求带上 User-Agent：

public function testUserAgentParsing()
{
    // 模拟一个 Chrome 浏览器的 User-Agent
    $response = $this->withHeaders([
        'User-Agent' => 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/114.0.0.0 Safari/537.36',
    ])->get('/your-target-route');

    // 这里可以添加你的断言逻辑，比如验证 agent 解析结果
    $this->assertTrue($response->ok());
}

这样请求到达控制器时，就能正常读取到 User-Agent 信息了。

2. 直接给 jenssegers/agent 设置 User-Agent #

如果不想每次都给请求加头，也可以直接操作 Agent 实例，强制设置 User-Agent。比如在测试类的setUp方法里全局配置：

use Jenssegers\Agent\Agent;

protected function setUp(): void
{
    parent::setUp();
    
    // 获取 Agent 实例并设置测试用的 User-Agent
    $agent = app(Agent::class);
    $agent->setUserAgent('Mozilla/5.0 (Macintosh; Intel Mac OS X 13_4) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/16.5 Safari/605.1.15');
}

这样整个测试类里的 Agent 都会使用你指定的 User-Agent，无需修改请求头。

3. 全局配置所有测试的默认请求头 #

如果你的所有测试都需要携带 User-Agent，可以在项目根测试类tests/TestCase.php的setUp方法里统一设置：

protected function setUp(): void
{
    parent::setUp();
    
    // 给所有测试请求默认带上 User-Agent
    $this->withHeaders([
        'User-Agent' => 'PHPUnit Test Bot/1.0',
    ]);
}

所有继承这个基类的测试用例，都会自动带上这个请求头，一劳永逸。

补充说明：Laravel 的测试框架是通过模拟 HTTP 请求的方式运行测试，不会像真实浏览器那样自动填充所有标准请求头，所以这类需要依赖特定请求头的功能，必须手动补充对应的信息，jenssegers/agent 本质上也是基于请求中的 User-Agent 字符串做解析，只要确保这个字符串存在（不管是通过请求头还是直接设置），就能正常工作。

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