Laravel 10+Sanctum接口：Postman传username始终为NULL问题求助

可能的原因及解决方案 #

1. 检查请求中间件是否过滤了username字段 #

Laravel的全局或路由中间件可能会修改、过滤请求参数，比如自定义中间件、第三方包的处理逻辑：

• 临时注释app/Http/Kernel.php中api路由组的非必要中间件（比如自定义的参数处理中间件），测试请求是否正常
• 在控制器方法最开头添加dd($request->all());，确认服务器实际接收到的参数列表，如果username确实不存在，说明是请求发送或中间件拦截问题

2. 确认User模型的批量赋值白名单 #

虽然验证逻辑在模型创建前执行，但如果username不在$fillable中，会导致模型无法赋值，建议确认：

// app/Models/User.php
protected $fillable = ['username', 'email', 'password'];

3. 排查Postman的请求配置细节 #

即使尝试了多种传参方式，也可能存在细节疏漏：

• 新建一个Postman请求，避免旧请求的缓存干扰
• 使用raw(JSON)格式时，确保Content-Type头设置为application/json，且JSON格式正确：

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

• 检查form-data/x-www-form-urlencoded的键名是否有空格、大小写错误（比如误写为Username）

4. 确认路由归属API路由组 #

确保注册/登录路由定义在routes/api.php中，而非web.php：

// routes/api.php
Route::post('register', [AuthController::class, 'register']);
Route::post('login', [AuthController::class, 'login']);

api路由组默认不应用CSRF验证，而web路由组的CSRF机制可能会干扰参数传递（虽少见，但需排除）

5. 通过Laravel日志定位问题 #

检查storage/logs/laravel.log中的请求记录，或在控制器中主动输出日志：

use Illuminate\Support\Facades\Log;

// 在控制器方法开头添加
Log::info('Received request parameters:', $request->all());

通过日志确认服务器端是否真的未接收到username参数，进一步缩小问题范围

6. 排查服务器配置（如Nginx） #

极少数情况下，服务器配置可能会过滤特定字段，比如Nginx的request_filter模块，可检查服务器配置文件是否有相关规则

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