如何使用 JavaScript 在 Django 中正确上传并更新用户头像

云浩大大_3101

云浩大大_3101

2026-01-30

924人浏览

原创

如何使用 JavaScript 在 Django 中正确上传并更新用户头像

本文详解 django 中通过 javascript 实现头像异步上传的完整流程,重点解决 formdata 构建错误、csrf 头缺失及视图逻辑不匹配等常见问题,确保文件成功保存至数据库并实时生效。

在 Django 应用中实现“点击按钮选择图片 → 异步上传 → 更新用户头像”这一功能时,许多开发者会遇到“上传成功但数据库未更新”的问题。根本原因通常在于前端 FormData 的构建方式与后端表单处理逻辑不匹配。下面我们将从HTML 结构、JavaScript 逻辑、Django 视图和表单设计四个层面给出完整、可运行的解决方案。

✅ 正确的 HTML 表单结构(关键:无需 action 和 method,禁用默认提交)


{% csrf_token %}

⚠️ 注意:

  • 移除 method="post" 和 action 属性——因为我们将完全由 JS 控制提交;
  • 为 显式添加 name="profile_photo",该名称必须与 Django 表单字段名(或 request.FILES 中的键)严格一致;
  • accept="image/*" 提升用户体验,限制仅可选图片文件。

✅ 正确的 JavaScript 上传逻辑(核心:手动构造 FormData + 原生 XHR 或 fetch)

推荐使用 fetch(现代简洁),但需注意:不能在 fetch 中同时设置 Content-Type 头(浏览器会自动设置为带 boundary 的 multipart/form-data,手动设置会导致失败):

document.addEventListener("DOMContentLoaded", function () {
  const uploadButton = document.getElementById("uploadButton");
  const fileInput = document.getElementById("fileInput");

  uploadButton.addEventListener("click", () => fileInput.click());

  fileInput.addEventListener("change", function () {
    if (!this.files || this.files.length === 0) return;

    const formData = new FormData();
    formData.append("profile_photo", this.files[0]); // 字段名必须与表单定义一致

    fetch("{% url 'update_profil_photo' %}", {
      method: "POST",
      body: formData,
      headers: {
        "X-CSRFToken": "{{ csrf_token }}"
      }
      // ❌ 不要加 'Content-Type': ... —— 让浏览器自动设置!
    })
    .then(response => response.json())
    .then(data => {
      if (data.success) {
        alert("Profile photo updated successfully!");
        // ✅ 可选:刷新头像预览(如 @@##@@)
        // document.getElementById("avatar").src = "/media/" + data.photo_url; // 根据实际返回调整
      } else {
        alert("Failed to update photo: " + (data.error || "Unknown error"));
      }
    })
    .catch(err => {
      console.error("Upload error:", err);
      alert("Network error. Please try again.");
    });
  });
});

✅ Django 视图与表单(确保接收并保存文件)

你的视图基本正确,但需补充两点关键改进:

DeepBI DHTML 页面生成器
DeepBI DHTML 页面生成器

生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力: - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面; - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”; - 提及位于 `apps/console/src/featur

下载
  1. UserProfilePictureUpdateForm 必须正确定义 profile_photo 字段(例如 models.ImageField 对应的 ModelForm 字段);
  2. 返回 JSON 时建议附带新图片 URL,便于前端刷新显示。
# forms.py
class UserProfilePictureUpdateForm(forms.ModelForm):
    class Meta:
        model = UserProfile
        fields = ['profile_photo']  # 确保字段名与 JS 中 formData.append 的 key 一致
        widgets = {
            'profile_photo': forms.ClearableFileInput(attrs={'class': 'd-none'}),
        }

# views.py
from django.http import JsonResponse
from django.contrib import messages
from django.urls import reverse
import os

@login_required
def update_profil_photo(request):
    user_profile = get_object_or_404(UserProfile, user=request.user)

    if request.method == 'POST':
        form = UserProfilePictureUpdateForm(
            request.POST, request.FILES, instance=user_profile
        )
        if form.is_valid():
            updated_profile = form.save()
            # 返回新图片 URL(需确保 media 配置正确且可访问)
            photo_url = updated_profile.profile_photo.url if updated_profile.profile_photo else ""
            return JsonResponse({
                'success': True,
                'photo_url': photo_url,
                'message': 'Profile photo updated successfully.'
            })
        else:
            return JsonResponse({
                'success': False,
                'error': dict(form.errors.items())  # 返回详细错误供调试
            }, status=400)

    return JsonResponse({'success': False, 'error': 'Only POST method allowed.'}, status=405)

? 注意事项与最佳实践

  • CSRF Token 安全性:模板中 {{ csrf_token }} 是字符串,JS 中需用双大括号包裹("{{ csrf_token }}"),确保渲染后为真实 token 值;
  • 文件验证:应在 Form 中加入 clean_profile_photo 方法校验文件类型/大小(如仅允许 JPG/PNG,≤5MB);
  • 媒体文件配置:确认 settings.py 中已配置:
    MEDIA_URL = '/media/'
    MEDIA_ROOT = os.path.join(BASE_DIR, 'media')

    并在开发环境下 urls.py 添加:

    from django.conf import settings
    from django.conf.urls.static import static
    urlpatterns += static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)
  • 生产环境部署:Nginx/Apache 需代理 /media/ 请求到 MEDIA_ROOT;
  • 用户体验增强:上传前禁用按钮、显示加载状态、上传后自动刷新 标签 src。

通过以上结构化实现,即可稳定、安全、专业地完成 Django 中基于 JS 的头像异步更新功能。

Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
nginx 重启
nginx 重启

nginx重启对于网站的运维来说是非常重要的,根据不同的需求,可以选择简单重启、平滑重启或定时重启等方式。本专题为大家提供nginx重启的相关的文章、下载、课程内容,供大家免费下载体验。

2023.07.27

423

5

nginx 配置详解
nginx 配置详解

Nginx的配置是指设置和调整Nginx服务器的行为和功能的过程。通过配置文件,可以定义虚拟主机、HTTP请求处理、反向代理、缓存和负载均衡等功能。Nginx的配置语法简洁而强大,允许管理员根据自己的需要进行灵活的调整。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.04

4307

6

nginx配置详解
nginx配置详解

NGINX与其他服务类似,因为它具有以特定格式编写的基于文本的配置文件。本专题为大家提供nginx配置相关的文章,大家可以免费学习。

2023.08.04

7225

6

tomcat和nginx有哪些区别
tomcat和nginx有哪些区别

tomcat和nginx的区别:1、应用领域;2、性能;3、功能;4、配置;5、安全性;6、扩展性;7、部署复杂性;8、社区支持;9、成本;10、日志管理。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

601

5

nginx报404怎么解决
nginx报404怎么解决

当访问 nginx 网页服务器时遇到 404 错误,表明服务器无法找到请求资源,可以通过以下步骤解决:1. 检查文件是否存在且路径正确;2. 检查文件权限并更改为 644 或 755;3. 检查 nginx 配置,确保根目录设置正确、没有冲突配置等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.07.09

1516

5

Nginx报404错误解决方法
Nginx报404错误解决方法

解决方法:只需要加上这段配置:try_files $uri $uri/ /index.html;即可。想了解更多Nginx的相关内容,可以阅读本专题下面的文章。

2024.08.07

3998

3

nginx部署php项目教程汇总
nginx部署php项目教程汇总

本专题整合了nginx部署php项目教程汇总,阅读专题下面的文章了解更多详细内容。

2026.01.13

122

12

nginx配置文件详细教程
nginx配置文件详细教程

本专题整合了nginx配置文件相关教程详细汇总,阅读专题下面的文章了解更多详细内容。

2026.01.13

597

23

Nginx跨平台安装实操指南:Windows、macOS与Linux环境快速搭建
Nginx跨平台安装实操指南:Windows、macOS与Linux环境快速搭建

本指南详解Nginx在Windows、macOS及Linux系统的安装全流程。涵盖官方包解压、Homebrew一键部署、APT/YUM源配置及Docker容器化方案。无论新手或开发者,均可快速搭建运行环境,掌握跨平台核心指令,为后续配置与调优奠定坚实基础。

2026.03.16

179

12

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WebStorm 官方调试文档
WebStorm 官方调试文档

共0课时 | 0人学习

React 教程
React 教程

共58课时 | 12.6万人学习

TypeScript 教程
TypeScript 教程

共19课时 | 6.8万人学习