讲师中心 微信公众号

工具推荐

视频效率加速
立刻MV
立刻MV

低成本歌曲 MV、视频生成

Laper
Laper

剧本策划到成片协作

AniShort
AniShort

AI短剧协同制作平台

剧云
剧云

中文短剧剧本制作平台

如何通过 AJAX 将前端图像数组(File 对象)正确提交至后端控制器

千涛同学_1100

千涛同学_1100

发布时间:2026-02-15 10:23:03

|

470人浏览过

|

来源于php中文网

原创

如何通过 AJAX 将前端图像数组(File 对象)正确提交至后端控制器

本文详解如何在 JavaScript 中将用户通过 选择的多个图像文件(File 对象)持久化保存并完整传递给 ASP.NET MVC 或其他后端控制器,重点解决“从 output 元素中提取图像对应原始文件”这一常见误区。

本文详解如何在 javascript 中将用户通过 `` 选择的多个图像文件(file 对象)持久化保存并完整传递给 asp.net mvc 或其他后端控制器,重点解决“从 `output` 元素中提取图像对应原始文件”这一常见误区。

在 Web 图像上传场景中,一个典型需求是:用户选择多张图片 → 前端预览缩略图 → 用户可删除部分图片 → 最终将原始二进制文件数据(而非仅 base64 或 URL)通过 AJAX 提交至后端控制器。然而,许多开发者误以为可通过 output.querySelectorAll('img') 获取 src 属性再还原为 File 对象——这是不可行的:URL.createObjectURL(file) 生成的是临时内存 URL,它不包含原始 File 实例,也无法反向解析出 File 对象。

✅ 正确做法是:全程保留对原始 File 对象的引用,并在发送请求时直接使用这些对象构造 FormData。

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

阿拉丁·前端工程工坊|脚手架·组件·规范落地·构建优化·性能与可访问性一体
阿拉丁·前端工程工坊|脚手架·组件·规范落地·构建优化·性能与可访问性一体

阿拉丁·前端工程工坊把「前端只会写页面、规范停在文档里、脚手架手敲、构建靠抄、性能靠猜、可访问性靠忘」从「手动搭项目、抄配置、肉眼查规范」升级成一条本地工具链——多框架脚手架生成(React/Vue3/Svelte + Vite)、可复用组件生成(Props 类型+样式+示例)、规范落地检查(lint-lite:命名/未用变量/console残留/TS any/目录结构)、构建配置生成与产物体积预算、性能审计(依赖体积/重复/懒加载/Lighthouse 清单)、可访问性(a11y)校验(alt/aria

下载

✅ 步骤一:维护可编辑的 File 数组(关键!)

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

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

function displayImages() {
  output.innerHTML = imagesArray.map((file, index) => `
    <div class="image" data-index="${index}">
      <img src="${URL.createObjectURL(file)}" alt="preview" loading="lazy">
      <span class="delete-btn" onclick="deleteImage(${index})">&times;</span>
    </div>
  `).join('');
}

⚠️ 注意:URL.createObjectURL() 仅用于预览;其返回值不可用于上传,且需在页面卸载前调用 URL.revokeObjectURL() 释放内存(见文末注意事项)。

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

✅ 步骤二:安全删除与更新数组

function deleteImage(index) {
  if (index >= 0 && index < imagesArray.length) {
    URL.revokeObjectURL(imagesArray[index].webkitRelativePath ? 
      imagesArray[index].webkitRelativePath : 
      URL.createObjectURL(imagesArray[index])); // 更稳妥地释放(见下文)

    imagesArray.splice(index, 1);
    displayImages();
  }
}

✅ 步骤三:构造 FormData 并发送 AJAX 请求

function sendImages() {
  const fileData = new FormData(); // 注意:new FormData(),不是 FormData()

  // ✅ 直接遍历原始 File 对象数组(这才是可上传的有效数据)
  imagesArray.forEach((file, index) => {
    fileData.append("files", file); // 后端接收参数名需匹配(如 ASP.NET MVC:IList<IFormFile> files)
  });

  $.ajax({
    type: "POST",
    url: "/ChinaProblemsReport/SendImage/",
    data: fileData,
    contentType: false,   // 禁用自动设置 Content-Type(让浏览器设为 multipart/form-data)
    processData: false,   // 禁用 jQuery 对 data 的默认序列化
    xhr: function() {
      const xhr = new window.XMLHttpRequest();
      xhr.upload.addEventListener("progress", (evt) => {
        if (evt.lengthComputable) {
          console.log(`上传进度: ${(evt.loaded / evt.total * 100).toFixed(2)}%`);
        }
      }, false);
      return xhr;
    }
  })
  .done(() => {
    alert("图片上传成功!");
    window.location.reload();
  })
  .fail((xhr) => {
    console.error("上传失败:", xhr.responseJSON || xhr.statusText);
  });
}

? 后端接收示例(ASP.NET MVC Controller)

[HttpPost]
public IActionResult SendImage(IList<IFormFile> files)
{
    if (files == null || files.Count == 0)
        return BadRequest("未收到任何文件");

    var uploadPath = Path.Combine(_webHostEnvironment.WebRootPath, "uploads");
    Directory.CreateDirectory(uploadPath);

    foreach (var file in files)
    {
        var fileName = Guid.NewGuid() + Path.GetExtension(file.FileName);
        var filePath = Path.Combine(uploadPath, fileName);
        using (var stream = System.IO.File.Create(filePath))
        {
            file.CopyTo(stream);
        }
    }

    return Ok(new { message = "上传完成", count = files.Count });
}

⚠️ 重要注意事项

  • 不要尝试从 如何通过 AJAX 将前端图像数组(File 对象)正确提交至后端控制器 中恢复 File 对象:src 是只读字符串,无法逆向获取原始 File。
  • 必须使用 new FormData():FormData() 是构造函数,漏掉 new 会报错。
  • 及时释放 Object URLs:每次调用 URL.createObjectURL(file) 后,应在不再需要预览时(如删除图片或页面卸载前)调用 URL.revokeObjectURL(url),避免内存泄漏。
  • 兼容性处理:现代浏览器均支持 Array.from(files);若需支持旧版 IE,可改用 Array.prototype.slice.call(files)。
  • 文件校验建议:在 sendImages() 中加入大小、类型校验(如 file.size

通过以上结构化实现,你将获得一个稳定、可维护、符合 Web 标准的多图上传流程——核心在于:始终操作原始 File 对象,而非 DOM 渲染结果。

热门AI工具

更多
WorkBuddy

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

豆包大模型

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

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

讯飞智文

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

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

DeepSeek

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

相关专题

更多
ajax教程
ajax教程

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

3540

2023.06.14

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

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

360

2023.08.31

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

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

3353

2023.11.15

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

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

1181

2024.09.24

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

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

1938

2023.08.03

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

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

3224

2023.09.04

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

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

6424

2023.10.24

字符串介绍
字符串介绍

字符串是一种数据类型,它可以是任何文本,包括字母、数字、符号等。字符串可以由不同的字符组成,例如空格、标点符号、数字等。在编程中,字符串通常用引号括起来,如单引号、双引号或反引号。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

6629

2023.11.24

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

140

2026.11.12

热门下载

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

精品课程

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

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