Laravel文件上传失败求助：表单文件未提交至控制器

1. serialize()的局限性：这个方法只能序列化文本类表单字段，文件（二进制数据）和未勾选的复选框不会被包含进去——未勾选的复选框本身是HTML默认不提交的字段，而文件数据无法通过字符串序列化的方式传递。
2. 请求Content-Type不匹配：$.post默认会把请求的Content-Type设为application/x-www-form-urlencoded，哪怕表单设置了enctype="multipart/form-data"，用serialize()提交也会覆盖这个配置，导致后端无法识别文件数据。

1. 改用FormData对象提交表单 #

FormData原生支持文件和表单数据的封装，能正确适配multipart/form-data类型的请求。修改前端提交代码如下：

// 获取弹窗里的表单元素
const form = document.getElementById('create');
// 创建FormData实例，自动包含表单所有字段（包括文件、勾选的复选框）
const formData = new FormData(form);

// 用$.ajax代替$.post，需要手动配置关键参数
$.ajax({
    url: '/contractors', // 替换为你的store路由地址
    method: 'POST',
    data: formData,
    contentType: false, // 禁止jQuery自动设置Content-Type，让浏览器自动处理
    processData: false, // 禁止jQuery处理FormData，避免破坏文件数据结构
    headers: {
        'X-CSRF-TOKEN': $('meta[name="csrf-token"]').attr('content') // Laravel必填的CSRF令牌
    },
    success: function(res) {
        // 提交成功后的逻辑：关闭弹窗、提示成功等
        Swal.close();
        Swal.fire('提交成功', '', 'success');
    },
    error: function(xhr) {
        Swal.fire('提交失败', '请检查表单后重试', 'error');
    }
});

2. 处理未勾选的复选框（可选） #

如果需要在approved复选框未勾选时，也向后端传递一个默认值（比如0），可以在复选框前添加一个同名隐藏输入框：

<!-- 隐藏输入框：未勾选时提交0 -->
<input type="hidden" name="approved" value="0">
<!-- 复选框：勾选时提交1，覆盖隐藏框的值 -->
<input type="checkbox" name="approved" value="1" id="approved">

3. 后端控制器适配 #

确保store方法正确接收文件和复选框参数：

public function store(Request $request)
{
    // 验证规则，根据你的业务调整
    $validated = $request->validate([
        'name' => 'required|string',
        'approved' => 'boolean',
        'attachment' => 'required|file|mimes:pdf,jpg,png', // 文件验证规则
    ]);

    // 处理文件上传
    if ($request->hasFile('attachment')) {
        $filePath = $request->file('attachment')->store('contractor_attachments');
        // 将$filePath存入数据库等操作
    }

    // 处理复选框值
    $isApproved = $request->boolean('approved'); // 自动转换为true/false

    // 其他数据保存逻辑...

    return response()->json(['message' => '数据提交成功']);
}

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