0

0

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

霞舞

霞舞

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

|

430人浏览过

|

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

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

Lemonaid
Lemonaid

AI音乐生成工具,在音乐领域掀起人工智能革命

下载

✅ 步骤一:维护可编辑的 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}">
      @@##@@
      <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 });
}

⚠️ 重要注意事项

  • 不要尝试从 preview 中恢复 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 渲染结果。

如何通过 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等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

244

2024.09.24

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

字符串介绍
字符串介绍

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

640

2023.11.24

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

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

76

2026.02.13

热门下载

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

精品课程

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

共57课时 | 11.3万人学习

CSS3 教程
CSS3 教程

共18课时 | 5.6万人学习

Vue 教程
Vue 教程

共42课时 | 8.4万人学习

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

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