Laravel 5.5 API单元测试报错：预期201却返回500，Postman正常求解决

嘿，我之前碰到过一模一样的情况——Postman调用完全正常，但单元测试死活报500。咱们从几个常见的方向一步步排查：

• 检查测试环境的数据库配置
  单元测试默认走testing环境配置，你得确认.env.testing里的数据库连接和config/database.php中connections的测试环境配置匹配。比如是不是用了SQLite内存库但没在测试前执行迁移？可以给测试类加上RefreshDatabase trait自动处理迁移回滚：

  use Illuminate\Foundation\Testing\RefreshDatabase;
  
  class RegisterTest extends TestCase
  {
      use RefreshDatabase; // 自动完成测试数据库的迁移与回滚
  
      // ... 你的测试方法
  }
  

  另外也要确认测试数据库的权限足够，比如MySQL用户有没有创建表、写入数据的权限。

• 确保请求头符合API要求
  Postman调用API时默认会带Accept: application/json，但单元测试如果没设置这个头，RegistersUsers trait里的register方法可能会把请求当成普通Web请求处理，导致跳转或逻辑异常。测试时可以用postJson方法（自动带JSON头），或者手动设置请求头：

  // 方式1：用postJson自动处理JSON请求头
  $response = $this->postJson('/register', [
      'name' => 'Test User',
      'email' => 'test@example.com',
      'password' => 'password',
      'password_confirmation' => 'password',
  ]);
  
  // 方式2：手动设置请求头
  $response = $this->withHeaders([
      'Accept' => 'application/json',
  ])->post('/register', $yourData);
  

• 排查registered()方法的自定义逻辑
  既然register()会调用registered()，你是不是在RegisterController里重写了这个方法？比如里面有没有发送邮件、调用第三方服务的逻辑？测试环境下如果邮件配置不对（比如没设MAIL_DRIVER=log），或者第三方服务不可用，就会直接抛出500错误。可以先注释掉registered()里的非核心逻辑，看看测试是否正常，再逐步定位问题点。

• 查看测试环境的错误日志
  别只盯着测试返回的500提示，去storage/logs/laravel-test.log里找具体的错误堆栈！比如是不是某个字段验证失败、模型关联出错，或者权限问题？如果日志找不到，也可以在测试里直接打印响应内容：

  $response = $this->postJson('/register', $yourData);
  dump($response->getContent()); // 打印具体的错误详情
  $response->assertStatus(201);
  

• 核对测试数据的完整性
  确认测试时传递的参数和Postman里的完全一致——比如有没有漏掉password_confirmation字段？或者字段格式不符合验证规则（比如邮箱格式错误、密码长度不够）？可以先暂时简化验证规则，看看测试是否能通过，再逐步恢复规则排查问题。

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