Laravel外键异常：创建帖子时user_id字段始终为null

核心问题分析 #

你的代码存在三个关键问题：

1. Post模型未设置可批量赋值字段：Post::create()依赖批量赋值，但Post模型未声明$fillable，导致user_id被Laravel的批量赋值保护机制过滤
2. API路由未加认证中间件：创建帖子的路由未验证用户登录状态，Auth::id()可能返回null
3. posts表user_id字段允许为空：迁移中设置了nullable()，无值时会存入null；移除该属性后，必填字段缺失就触发数据库错误

具体修复步骤 #

1. 给Post模型添加$fillable属性

打开app/Models/Post.php，添加可批量赋值的字段列表，包含user_id：

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;

class Post extends Model
{
    use HasFactory;

    // 允许批量赋值的字段
    protected $fillable = [
        'user_id',
        'username',
        'blood_type',
        'status',
        'contact_info',
        'description'
    ];

    // 与User模型的关联
    public function user(){
        return $this->belongsTo(User::class, 'user_id');
    }
}

2. 给API路由添加认证中间件

由于你使用了Laravel Sanctum（User模型引入了HasApiTokens），需给创建帖子的路由加上sanctum中间件，确保仅登录用户能访问：

// 创建帖子路由
Route::post('/posts', [PostController::class, 'store'])->middleware('auth:sanctum');

3. 修复posts表迁移（推荐）

移除user_id的nullable()，确保帖子必须关联用户：

// 修改posts表迁移中的user_id字段
$table->foreignId('user_id')->constrained()->onDelete('cascade');

修改后可通过以下方式更新数据库：

# 若迁移刚创建不久，先回滚再重新执行
php artisan migrate:rollback
php artisan migrate

# 或创建新迁移修改字段
php artisan make:migration alter_user_id_in_posts_table

新迁移示例：

<?php

use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;

return new class extends Migration
{
    public function up(): void
    {
        Schema::table('posts', function (Blueprint $table) {
            $table->foreignId('user_id')->nullable(false)->change();
        });
    }

    public function down(): void
    {
        Schema::table('posts', function (Blueprint $table) {
            $table->foreignId('user_id')->nullable()->change();
        });
    }
};

执行新迁移：

php artisan migrate

4. 优化控制器代码（可选）

通过用户关联直接创建帖子，无需手动设置user_id，更符合Laravel关联用法：

// 存储帖子数据
public function store(PostRequest $request){
    $request->user()->posts()->create($request->validated());
}

验证修复效果 #

1. 确保API请求携带有效的Sanctum令牌（请求头添加Authorization: Bearer {token}）
2. 重新创建帖子，检查posts表的user_id字段是否已正确存储当前登录用户ID

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