Laravel 10控制器存数据到MySQL遇Postman 500错误求助

1. 先抓具体错误信息（最关键） #

500是通用错误，必须看Laravel日志定位问题：

• Docker环境下，直接进入Laravel容器查看日志：

  docker exec -it [你的Laravel容器名称] tail -f storage/logs/laravel.log
  

• 日志会明确指出错误原因：比如数据库连接失败、字段不存在、批量赋值未授权、路由匹配错误等，这是排查的核心依据。

2. 数据库连接验证 #

• 检查项目根目录.env文件的数据库配置，Docker环境注意DB_HOST要填MySQL容器的服务名（不是localhost）：

  DB_CONNECTION=mysql
  DB_HOST=mysql  # 对应docker-compose.yml里mysql服务的名称
  DB_PORT=3306
  DB_DATABASE=你的数据库名
  DB_USERNAME=数据库用户名
  DB_PASSWORD=数据库密码
  

• 用TablePlus连接容器内的MySQL，确认能正常访问，且目标表已通过迁移创建。

3. 迁移文件与表结构检查 #

• 确认迁移已执行：

  docker exec -it [Laravel容器名称] php artisan migrate
  

• 核对迁移文件中的字段，确保和你要存储的输入字段完全对应。比如你要存username，迁移里必须有$table->string('username')这类定义。

4. 模型批量赋值配置 #

Laravel默认禁止批量赋值，必须在模型中声明允许的字段：

class User extends Model
{
    use HasFactory;

    // 允许批量赋值的字段，和你要存储的输入字段对应
    protected $fillable = ['username', 'email', 'phone'];
}

如果控制器用Model::create($request->all())但未设置$fillable，会直接触发500错误。

5. 控制器代码优化与验证 #

• 给请求加验证规则，提前拦截非法输入，同时返回明确错误（而非500）：

  public function store(Request $request)
  {
      // 验证输入合法性
      $validated = $request->validate([
          'username' => 'required|string|max:255',
          'email' => 'required|email|unique:users',
      ]);
  
      // 存储数据
      $data = User::create($validated);
  
      return response()->json($data, 201);
  }
  

• 避免直接使用$request->all()，如果必须用，一定要确保$fillable覆盖所有传入字段。

6. 路由配置检查 #

• 确认API路由定义在routes/api.php中（默认带/api前缀）：

  Route::post('/users', [UserController::class, 'store']);
  

• Postman请求URL要对应，比如http://localhost:8000/api/users（根据你的端口映射调整）。

7. Docker环境额外检查 #

• 确保Laravel容器和MySQL容器在同一个Docker网络中，可查看docker-compose.yml的network配置：

  services:
    app:
      build: .
      networks:
        - laravel
    mysql:
      image: mysql:8.0
      networks:
        - laravel
  networks:
    laravel:
      driver: bridge
  

• 确认MySQL容器处于运行状态：docker ps查看容器状态，未启动则执行docker-compose up -d mysql。

8. Postman请求规范 #

• 请求方法选POST，Headers添加Accept: application/json，确保Laravel返回JSON格式错误信息。
• 请求体用raw -> JSON格式，示例：

  {
      "username": "test_user",
      "email": "test@example.com"
  }
  

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