讲师中心 微信公众号
AI工具推荐 视频效率加速

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

落雪吖_1274

落雪吖_1274

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

|

247人浏览过

|

来源于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。

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

HISUI 前端框架开发指南(IRIS版)
HISUI 前端框架开发指南(IRIS版)

HISUI 前端框架基础开发指南。HISUI 是基于 easyui 二次开发的 jQuery UI 组件库,专为医疗信息系统设计。当涉及 HISUI 组件开发、jQuery easyui 表格/表单/布局/窗口、医疗系统前端页面编写时使用此 skill。 涵盖 40 个组件的官方文档参考,支持声明式与编程式两种初始化方式,提供 $cm/$m 数据访问方法。

下载

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}">
      <img src="${URL.createObjectURL(file)}" alt="preview" loading="lazy">
      <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("上传失败,请检查网络或文件格式。");
    }
  });
}

❌ 错误示例(务必避免)

// ❌ 错误:试图从 <img  alt="如何使用 AJAX 将前端图片数组(File 对象)正确提交至后端控制器" > 的 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

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

热门AI工具

更多
创客贴AI

创客贴AI是一款AI图像与设计工具,AI辅助的智能在线设计工具。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

讯飞智文

一款面向学习和办公场景的AI文档创作工具,可辅助生成PPT与Word文档,提高资料整理和内容制作效率。

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

相关专题

更多
ajax教程
ajax教程

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

3340

2023.06.14

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

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

360

2023.08.31

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

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

3153

2023.11.15

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

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

1161

2024.09.24

php中foreach用法
php中foreach用法

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

818

2025.12.04

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

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

1878

2023.08.03

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

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

3044

2023.09.04

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

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

6324

2023.10.24

Postman身份认证怎么配置
Postman身份认证怎么配置

本专题从实际API接口调试场景出发,讲解Postman身份认证的完整配置流程,包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查,帮助用户正确完成接口授权与访问验证。

0

2026.11.06

热门下载

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

精品课程

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn