Laravel中使用jQuery提交表单时控制器无法获取上传图片文件

你现有代码的核心逻辑没有大问题，拿不到上传文件基本都是几个容易漏的细节导致的，按下面的步骤排查修复就行：

先排查基础配置问题 #

• 检查PHP配置：打开php.ini确认upload_max_filesize、post_max_size两个值大于你要上传的图片大小，超过限制的文件会被PHP直接丢弃，后端拿不到任何数据。改完配置记得重启php-fpm或者对应的Web服务。
• 打开浏览器F12开发者工具，找到这次提交的网络请求，看请求Payload里有没有file对应的二进制文件内容：如果请求里根本没带文件，问题在前端；如果请求带了文件后端拿不到，问题在服务端配置。
• 如果用Nginx做反向代理，记得给Nginx配置加client_max_body_size 20M;，否则超过大小的请求会被Nginx直接拦截，到不了Laravel层。

前端代码兼容性修复 #

部分jQuery版本直接给FormData传表单DOM会出现绑定失效的问题，改成显式追加字段的写法兼容性更好，同时把容易踩坑的配置调整下：

$(function(){        
    $("#forms").on('submit', function(e){
        e.preventDefault();
        let formData = new FormData();
        // 先追加所有普通表单字段
        $(this).find('input:not([type=file]), select, textarea').each(function(){
            // 跳过没有name属性的表单元素
            if(!$(this).attr('name')) return;
            formData.append($(this).attr('name'), $(this).val());
        });
        // 单独追加文件字段
        const fileEl = document.getElementById('file');
        if(fileEl.files.length){
            formData.append('file', fileEl.files[0]);
        }
        // 显式补csrf token，避免部分场景token丢失
        formData.append('_token', $('input[name="_token"]').val());

        $.ajax({
            url: $(this).attr('action'),
            method: 'POST',
            data: formData,
            processData: false, // 必须关，不然jQuery会把FormData转成字符串
            contentType: false, // 必须关，让浏览器自动生成带分隔符的multipart头
            // 去掉提前写死的dataType:'json'，后端返回非json时会直接进error回调，容易误判
            success: function(res){
                console.log('提交成功', res);
            },
            error: function(xhr){
                console.log('提交报错', xhr.responseText);
            }
        });
    });
});

注意：绝对不要手动给请求加Content-Type: multipart/form-data请求头，手动加的话不会带文件分隔符boundary，后端会解析失败。

Laravel端校验逻辑 #

不要直接return $request->all()或者$request->file('file')判断有没有拿到文件，先加校验规则确认文件存在：

public function store(Request $request){
    // 加表单校验，文件不符合规则会直接返回报错
    $validated = $request->validate([
        'file' => 'required|file|image|max:2048', // 限制为2M以内的图片
    ]);

    // 走到这一步说明文件已经正常接收，下面可以写存储逻辑
    $savePath = $request->file('file')->store('avatars');
    
    return response()->json([
        'status' => 'success',
        'file_path' => $savePath
    ]);
}

• 如果你写了全局请求预处理中间件，检查下有没有误清空$_FILES数组的逻辑，这类问题在自定义参数过滤的中间件里很常见。

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