0

0

如何使用 AJAX 将前端图片数组(File 对象)正确提交至后端控制器

碧海醫心

碧海醫心

发布时间:2026-02-14 21:51:01

|

207人浏览过

|

来源于php中文网

原创

如何使用 AJAX 将前端图片数组(File 对象)正确提交至后端控制器

本文详解如何在 JavaScript 中正确收集用户通过 选择的原始 File 对象,并通过 FormData + AJAX 提交至 ASP.NET MVC 或其他后端控制器,避免误用 DOM 元素的 src 属性导致二进制数据丢失。

本文详解如何在 javascript 中正确收集用户通过 `` 选择的原始 file 对象,并通过 formdata + ajax 提交至 asp.net mvc 或其他后端控制器,避免误用 dom 元素的 `src` 属性导致二进制数据丢失。

前端图片上传场景中,一个常见误区是:将预览用的 如何使用 AJAX 将前端图片数组(File 对象)正确提交至后端控制器 标签的 src(即 blob: URL)误当作可上传的文件数据。实际上,URL.createObjectURL(file) 仅生成临时访问地址,无法还原为原始 File 对象;若尝试用 output.querySelectorAll('img').forEach(img => img.src) 获取并上传这些 URL,后端收到的只是字符串而非二进制文件流,必然失败。

✅ 正确做法是:始终保留原始 File 对象引用,并在提交时直接使用它们构造 FormData。

以下是完整、健壮的实现方案:

LOVO AI
LOVO AI

AI人声和文本转语音生成工具

下载

1. 正确维护图片文件数组(关键!)

const output = document.querySelector("output");
const input = document.getElementById("roUpload");
let imagesArray = []; // ✅ 始终存储原生 File 对象

input.addEventListener("change", (e) => {
  const files = Array.from(e.target.files); // 转为数组便于操作
  imagesArray.push(...files);
  displayImages();
});

function displayImages() {
  const html = imagesArray.map((file, index) => `
    <div class="image" data-index="${index}">
      @@##@@
      <span onclick="deleteImage(${index})">&times;</span>
    </div>
  `).join('');
  output.innerHTML = html;
}

? 注意:imagesArray 存储的是 File 实例(继承自 Blob),具备 name、type、size 等元信息,且可被 FormData.append() 直接识别为二进制文件。

立即学习前端免费学习笔记(深入)”;

2. 删除图片时同步更新数组(保持一致性)

function deleteImage(index) {
  imagesArray.splice(index, 1);
  displayImages(); // 重新渲染,确保 DOM 与数组一致
}

3. 提交时使用原始 File 对象构建 FormData

function sendImages() {
  const fileData = new FormData(); // ✅ 使用 new FormData()

  // ✅ 直接遍历原始 File 数组(非 DOM 中的 img.src!)
  imagesArray.forEach((file, index) => {
    fileData.append("files", file); // 后端接收为 IFormFile[] 或 HttpPostedFileBase[]
  });

  // 可选:添加额外字段(如业务 ID)
  // fileData.append("reportId", "12345");

  $.ajax({
    type: "POST",
    url: "/ChinaProblemsReport/SendImage/",
    data: fileData,
    contentType: false,   // ⚠️ 必须设为 false,让浏览器自动设置 multipart/form-data
    processData: false,   // ⚠️ 必须设为 false,禁止 jQuery 序列化 data
    cache: false,         // 防止 IE 缓存 FormData
    success: function (response) {
      alert("上传成功!");
      window.location.reload();
    },
    error: function (xhr, status, err) {
      console.error("上传失败:", err);
      alert("上传失败,请检查网络或文件格式。");
    }
  });
}

❌ 错误示例(务必避免)

// ❌ 错误:试图从 @@##@@ 的 src 提取文件(src 是字符串,不是 File)
var files = output.querySelectorAll('img');
for (let i = 0; i < files.length; i++) {
  fileData.append("files", files[i].src); // ← 这只会传入一个 URL 字符串!
}

// ❌ 错误:new FormData() 写法不标准(应为 new FormData())
var fileData = FormData(); // ← 缺少 new 关键字,会报错

? 后端接收建议(以 ASP.NET MVC 为例)

[HttpPost]
public ActionResult SendImage(IEnumerable<HttpPostedFileBase> files)
{
    if (files == null || !files.Any()) 
        return Json(new { success = false, message = "未收到文件" });

    foreach (var file in files)
    {
        if (file != null && file.ContentLength > 0)
        {
            var fileName = Path.GetFileName(file.FileName);
            var path = Path.Combine(Server.MapPath("~/Uploads"), fileName);
            file.SaveAs(path);
        }
    }
    return Json(new { success = true });
}

✅ 总结要点

  • 核心原则:上传必须使用原始 File 对象,而非 blob: URL;
  • 数据一致性:DOM 预览与 imagesArray 必须严格同步(增删均需双向更新);
  • FormData 配置:contentType: false 和 processData: false 缺一不可;
  • 调试技巧:在控制台打印 console.log(imagesArray[0] instanceof File) 验证对象类型;
  • 用户体验:可增加上传进度条、文件大小校验(file.size

遵循以上模式,即可稳定、高效地将多图以原生二进制形式提交至任意支持文件上传的后端接口。

preview如何使用 AJAX 将前端图片数组(File 对象)正确提交至后端控制器

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
ajax教程
ajax教程

php中文网为大家带来ajax教程合集,Ajax是一种用于创建快速动态网页的技术。通过在后台与服务器进行少量数据交换,Ajax可以使网页实现异步更新。这意味着可以在不重新加载整个网页的情况下,对网页的某部分进行更新。php中文网还为大家带来ajax的相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

164

2023.06.14

ajax中文乱码解决方法
ajax中文乱码解决方法

ajax中文乱码解决方法有设置请求头部的字符编码、在服务器端设置响应头部的字符编码和使用encodeURIComponent对中文进行编码。本专题为大家提供ajax中文乱码相关的文章、下载、课程内容,供大家免费下载体验。

166

2023.08.31

ajax传递中文乱码怎么办
ajax传递中文乱码怎么办

ajax传递中文乱码的解决办法:1、设置统一的编码方式;2、服务器端编码;3、客户端解码;4、设置HTTP响应头;5、使用JSON格式。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

119

2023.11.15

ajax网站有哪些
ajax网站有哪些

使用ajax的网站有谷歌、维基百科、脸书、纽约时报、亚马逊、stackoverflow、twitter、hacker news、shopify和basecamp等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

243

2024.09.24

php中foreach用法
php中foreach用法

本专题整合了php中foreach用法的相关介绍,阅读专题下面的文章了解更多详细教程。

162

2025.12.04

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

551

2023.08.03

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

214

2023.09.04

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

1552

2023.10.24

pixiv网页版官网登录与阅读指南_pixiv官网直达入口与在线访问方法
pixiv网页版官网登录与阅读指南_pixiv官网直达入口与在线访问方法

本专题系统整理pixiv网页版官网入口及登录访问方式,涵盖官网登录页面直达路径、在线阅读入口及快速进入方法说明,帮助用户高效找到pixiv官方网站,实现便捷、安全的网页端浏览与账号登录体验。

76

2026.02.13

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Node.js 教程
Node.js 教程

共57课时 | 11.2万人学习

CSS3 教程
CSS3 教程

共18课时 | 5.5万人学习

Vue 教程
Vue 教程

共42课时 | 8.4万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号