Python Django 中正确序列化数据为 JSON 供前端使用

阿敏君_9488

阿敏君_9488

2026-04-28

284人浏览

原创

Python Django 中正确序列化数据为 JSON 供前端使用

在 Django 视图中手动构造 Python 字典列表并直接传入模板,会导致 HTML 属性中出现单引号格式的字符串(如 {'weight': '122.00'}),这不是合法 JSON,前端 JSON.parse() 会报错;应使用 json.dumps() 或 Django 内置 |json_script 过滤器生成标准双引号 JSON。

在 django 视图中手动构造 python 字典列表并直接传入模板,会导致 html 属性中出现单引号格式的字符串(如 `{'weight': '122.00'}`),这不是合法 json,前端 `json.parse()` 会报错;应使用 `json.dumps()` 或 django 内置 `|json_script` 过滤器生成标准双引号 json。

Django 模板默认将 Python 对象以 repr() 形式渲染(如单引号、无转义),这不是 JSON,不能被 JavaScript 安全解析。要实现前后端可靠数据传递,必须确保输出的是符合 RFC 8259 的标准 JSON 字符串——即键和字符串值均使用双引号,且特殊字符已正确转义。

✅ 正确做法一:在视图中使用 json.dumps()

首先导入标准库 json,然后对数据结构调用 dumps():

import json
from django.core.paginator import Paginator
from django.shortcuts import render, redirect
from django.contrib.auth.decorators import login_required

@login_required
def profile_page(request):
    # ... 表单处理逻辑(略)...

    user_weight_log = WeightRecord.objects.filter(
        profile__user=request.user
    ).order_by('-entry_date')

    paginator = Paginator(user_weight_log, 10)
    page = request.GET.get('page')
    try:
        user_weight_log = paginator.page(page)
    except PageNotAnInteger:
        user_weight_log = paginator.page(1)
    except EmptyPage:
        user_weight_log = paginator.page(paginator.num_pages)

    # ✅ 使用 json.dumps() 生成标准 JSON 字符串
    serialized_data = json.dumps([
        {
            'weight': str(record.weight),
            'entry_date': record.entry_date.strftime('%Y-%m-%d')
        }
        for record in user_weight_log
    ])

    return render(request, 'profile.html', {
        'user_weight_log': user_weight_log,
        'form': form,
        'weight_data': serialized_data  # ← 已是合法 JSON 字符串
    })

对应模板中,仍需 |safe(因 json.dumps() 输出含双引号和转义符的纯字符串,Django 会自动转义 等,破坏 JSON):

<div id="weight-data" data-weight-data="{{ weight_data|safe }}"></div>

前端 JavaScript 可安全解析:

const weightDataElement = document.getElementById('weight-data');
const weightDataJSON = weightDataElement.getAttribute('data-weight-data');
const weightData = JSON.parse(weightDataJSON); // ✅ 成功解析为数组
console.log(weightData[0].weight); // "122.00"

✅ 正确做法二(推荐):使用 Django |json_script 过滤器(Django ≥ 3.1)

更安全、更语义化的方式是借助 Django 内置的 json_script 模板过滤器,它自动处理转义、编码与 DOM 安全性,并将数据嵌入 <script type="application/json"> 标签中:</script>

视图保持原样(无需 json.dumps):

python学习
python学习

Python 编程学习助手 skill,面向零基础用户。 当用户表达以下意图时触发: - 学习 Python 基础概念(变量、数据类型、循环、函数、类等) - 请求 Python 练习题或测验 - 请求审查或调试 Python 代码 - 请求 Python 项目实战指导(爬虫、数据分析、Web 开发等入门项目) - 泛化表述如"教我 Python""我想学编程""Python 怎么写""帮我学 Python" 此 skill

下载
# 在视图中直接传入 Python 列表(无需序列化)
serialized_data = [
    {'weight': str(record.weight), 'entry_date': record.entry_date.strftime('%Y-%m-%d')}
    for record in user_weight_log
]
return render(request, 'profile.html', {
    'user_weight_log': user_weight_log,
    'form': form,
    'weight_data': serialized_data  # ← 仍是 Python list/dict
})

模板中使用过滤器:

{{ weight_data|json_script:"weight-data" }}

这将渲染为:

<script id="weight-data" type="application/json">[{"weight": "122.00", "entry_date": "2023-09-28"}, ...]</script>

前端读取(简洁且防 XSS):

const weightDataElement = document.getElementById('weight-data');
const weightData = JSON.parse(weightDataElement.textContent);

⚠️ 注意事项:

  • *永远不要在 `data-属性中直接插入未序列化的 Python 对象**(如{{ weight_data }}`),这是常见陷阱;
  • |json_script 是目前最推荐的方式:它避免了内联脚本风险、自动处理 Unicode 和特殊字符、无需手动 |safe;
  • 若必须用 data-* 属性,请确保服务端使用 json.dumps() + 模板 |safe,并验证输出是否为合法 JSON(可用 JSONLint 校验);
  • 所有日期、数值建议统一格式化(如 ISO 8601 字符串),避免前端解析歧义。

通过以上任一方式,即可彻底解决 JSON.parse: expected property name 错误,实现 Django 后端到前端 JavaScript 的健壮数据传递。

Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!

相关专题

更多
python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

2643

5

前端如何实现即时通讯
前端如何实现即时通讯

实现即时通讯的方法有WebSocket、Long Polling、Server-Sent Events、WebRTC等等。详细介绍:1、WebSocket,它可以在客户端和服务器之间建立持久连接,实现实时的双向通信,前端可以使用 WebSocket API来创建WebSocket连接,并通过发送和接收消息来实现即时通讯;2、Long Polling,是一种模拟实时通信的技术等等。

2023.10.09

5723

6

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

2024.03.19

6710

13

php和前端的关联介绍
php和前端的关联介绍

php既可以作为前端语言,也可以作为后端语言。想了解更多php和前端的相关内容,可以阅读本专题下面的文章。

2024.03.22

6418

10

前端外包工作内容有哪些
前端外包工作内容有哪些

前端外包工作内容包括:1. 网站和应用程序开发;2. 用户界面和交互设计;3. 用户体验优化;4. 设计和视觉开发;5. 跨浏览器兼容性;6. 性能优化;7. 维护和更新;8. 项目管理和沟通。想了解更多前端的相关内容,可以阅读本专题下面的文章。

2024.05.22

903

5

python打包成可执行文件
python打包成可执行文件

本专题为大家带来python打包成可执行文件相关的文章,大家可以免费的下载体验。

2023.07.20

1811

4

python能做什么
python能做什么

python能做的有:可用于开发基于控制台的应用程序、多媒体部分开发、用于开发基于Web的应用程序、使用python处理数据、系统编程等等。本专题为大家提供python相关的各种文章、以及下载和课程。

2023.07.25

4744

7

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.07.31

1749

3

python教程
python教程

Python已成为一门网红语言,即使是在非编程开发者当中,也掀起了一股学习的热潮。本专题为大家带来python教程的相关文章,大家可以免费体验学习。

2023.08.03

28257

23

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Uvicorn官方安装与入门手册
Uvicorn官方安装与入门手册

共0课时 | 0人学习

Python uv官方项目管理指南
Python uv官方项目管理指南

共0课时 | 0人学习

Python uv官方安装与入门文档
Python uv官方安装与入门文档

共0课时 | 0人学习