PHP Ajax上传时$_FILES数组为空的问题排查求助

前端核心配置 #

要通过Ajax上传文件，必须用FormData包装表单数据，同时注意两个关键请求设置：

• processData: false（仅jQuery需要）：禁止自动处理FormData，避免文件数据被转成字符串
• contentType: false：让浏览器自动生成带boundary的multipart/form-data请求头，这是文件上传的必要条件

正确代码示例 #

原生XHR写法

const form = document.getElementById('uploadForm');
const formData = new FormData(form);

const xhr = new XMLHttpRequest();
xhr.open('POST', 'your-handler.php', true);
xhr.onload = function() {
  if (xhr.status === 200) {
    console.log('上传结果：', xhr.responseText);
  }
};
xhr.send(formData);

jQuery写法

const formData = new FormData($('#uploadForm')[0]);

$.ajax({
  url: 'your-handler.php',
  type: 'POST',
  data: formData,
  processData: false,
  contentType: false,
  success: function(res) {
    console.log(res);
  }
});

后端与表单校验 #

• 表单必须设置enctype="multipart/form-data"，否则服务器无法识别文件：

  <form id="uploadForm" enctype="multipart/form-data">
    <input type="file" name="uploadFile">
    <input type="text" name="username">
    <button type="button" onclick="submitUpload()">提交</button>
  </form>
  

• 后端PHP中，$_FILES的键名要和前端文件输入框的name属性完全一致，比如前端name="uploadFile"，后端用$_FILES['uploadFile']获取
• 检查服务器php.ini配置：确保upload_max_filesize和post_max_size的值大于你要上传的文件大小

常见错误排查 #

• 不要手动给FormData设置Content-Type，浏览器会自动处理
• 禁止用JSON.stringify处理FormData，这会直接丢失文件二进制数据
• 检查是否有其他JS代码修改了FormData或阻止了正常的数据传递

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