0

0

将 GORM(或 gorp)查询结果正确序列化为 JSON 格式

霞舞

霞舞

发布时间:2025-12-26 12:00:48

|

574人浏览过

|

来源于php中文网

原创

将 GORM(或 gorp)查询结果正确序列化为 JSON 格式

本文详解如何将 gorp 查询得到的结构体切片正确转换为标准 json 字符串,解决因误用 `json.marshal` 或手动拼接导致的格式错误、乱码或非合法 json 问题。

在使用 gorp(一个轻量级 Go SQL 映射库)进行数据库查询后,开发者常希望将结果直接以 JSON 格式返回给前端或 API 客户端。但如示例所示,直接调用 json.Marshal() 后用 string() 转换再输出,本身逻辑正确;而问题中所谓“Option 1 输出数组数字”或“Option 2 输出无分隔的多个 JSON 对象”,通常并非 json.Marshal 的行为异常,而是以下常见误区所致:

核心正解:json.Marshal(manegalu) 本就生成合法的 JSON 数组(如 [{"mane_id":"3323",...}, {...}]),这才是符合 RFC 7159 的标准 JSON 响应。你期望的“逗号分隔的裸对象”(如 {"a":1},{"b":2})不是有效 JSON —— 它缺少外层数组/对象封装,JSON 解析器会直接报错。

❌ 错误认知示例:

MusicAI
MusicAI

AI音乐生成工具

下载
  • 认为 json.Marshal() 返回“乱码”或“数字数组”:实则是未检查 err,或 fmt.Fprint(w, string(a)) 前 a 为 nil/空切片,导致打印空字符串或意外字节
  • 手动循环 json.Marshal(p) 并逐个输出(Option 2):这会产生多个独立 JSON 对象(如 {"x":1}{"y":2}),非法 JSON,无法被任何标准解析器消费。

✅ 正确做法:一步序列化 + 正确响应头

type Mane struct {
    ManeId   string `db:"mane_id" json:"mane_id"`   // 添加 json tag 显式控制字段名
    Manetana string `db:"manetana" json:"manetana"`
    Yajamana string `db:"yajamana" json:"yajamana"`
}

var manegalu []Mane
_, err := dbmap.Select(&manegalu, "SELECT mane_id, manetana, yajamana FROM kd_mane")
if err != nil {
    http.Error(w, "DB query failed", http.StatusInternalServerError)
    return
}

// 1. 序列化整个切片 → 得到标准 JSON 数组字节
jsonData, err := json.Marshal(manegalu)
if err != nil {
    http.Error(w, "JSON marshal failed", http.StatusInternalServerError)
    return
}

// 2. 设置正确 Content-Type(关键!)
w.Header().Set("Content-Type", "application/json; charset=utf-8")

// 3. 直接写入响应体(无需额外截取或转换)
w.Write(jsonData) // 或 fmt.Fprint(w, string(jsonData))

⚠️ 注意事项与最佳实践

  • 必须添加 json tag:db tag 仅用于 gorp 映射,json tag 才控制序列化字段名与可见性。若省略,Go 默认导出大写首字母字段(如 ManeId → "ManeId"),与数据库列名 mane_id 不一致。
  • 不要手动拼接 JSON:避免 for range + Marshal + print,既不安全(无分隔符/换行)、不标准,且易引入 XSS 或编码风险。
  • 始终检查 err:json.Marshal 在结构体含不可序列化字段(如 func、chan、未导出字段循环引用)时会失败,忽略错误将导致空响应。
  • 设置 Content-Type:告知客户端这是 JSON,避免浏览器/工具误解析为 HTML 或文本。
  • 如需流式响应大数据:考虑使用 json.NewEncoder(w).Encode(manegalu),它自动处理缓冲与错误,更健壮。

✅ 验证输出示例(合法 JSON)

[
  {"mane_id":"3323","manetana":"ABC","yajamana":"hgy"},
  {"mane_id":"2323","manetana":"ADFC","yajamana":"FDER"},
  {"mane_id":"12343","manetana":"GDSC","yajamana":"hFDEy"}
]
? 提示:若后端必须输出“JSON Lines”(每行一个 JSON 对象),请明确使用 application/json-seq 类型,并用 json.NewEncoder(w).Encode(item) 循环输出——但这属于特殊协议,非常规 REST API 场景。

遵循以上方式,即可稳定、安全、标准化地将 gorp 查询结果输出为可被任意 JSON 客户端(Axios、fetch、jq 等)直接解析的响应。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

WorkBuddy
WorkBuddy

腾讯云推出的AI原生桌面智能体工作台

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
数据分析工具有哪些
数据分析工具有哪些

数据分析工具有Excel、SQL、Python、R、Tableau、Power BI、SAS、SPSS和MATLAB等。详细介绍:1、Excel,具有强大的计算和数据处理功能;2、SQL,可以进行数据查询、过滤、排序、聚合等操作;3、Python,拥有丰富的数据分析库;4、R,拥有丰富的统计分析库和图形库;5、Tableau,提供了直观易用的用户界面等等。

1135

2023.10.12

SQL中distinct的用法
SQL中distinct的用法

SQL中distinct的语法是“SELECT DISTINCT column1, column2,...,FROM table_name;”。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

340

2023.10.27

SQL中months_between使用方法
SQL中months_between使用方法

在SQL中,MONTHS_BETWEEN 是一个常见的函数,用于计算两个日期之间的月份差。想了解更多SQL的相关内容,可以阅读本专题下面的文章。

381

2024.02.23

SQL出现5120错误解决方法
SQL出现5120错误解决方法

SQL Server错误5120是由于没有足够的权限来访问或操作指定的数据库或文件引起的。想了解更多sql错误的相关内容,可以阅读本专题下面的文章。

2214

2024.03.06

sql procedure语法错误解决方法
sql procedure语法错误解决方法

sql procedure语法错误解决办法:1、仔细检查错误消息;2、检查语法规则;3、检查括号和引号;4、检查变量和参数;5、检查关键字和函数;6、逐步调试;7、参考文档和示例。想了解更多语法错误的相关内容,可以阅读本专题下面的文章。

380

2024.03.06

oracle数据库运行sql方法
oracle数据库运行sql方法

运行sql步骤包括:打开sql plus工具并连接到数据库。在提示符下输入sql语句。按enter键运行该语句。查看结果,错误消息或退出sql plus。想了解更多oracle数据库的相关内容,可以阅读本专题下面的文章。

1703

2024.04.07

sql中where的含义
sql中where的含义

sql中where子句用于从表中过滤数据,它基于指定条件选择特定的行。想了解更多where的相关内容,可以阅读本专题下面的文章。

586

2024.04.29

sql中删除表的语句是什么
sql中删除表的语句是什么

sql中用于删除表的语句是drop table。语法为drop table table_name;该语句将永久删除指定表的表和数据。想了解更多sql的相关内容,可以阅读本专题下面的文章。

440

2024.04.29

TypeScript类型系统进阶与大型前端项目实践
TypeScript类型系统进阶与大型前端项目实践

本专题围绕 TypeScript 在大型前端项目中的应用展开,深入讲解类型系统设计与工程化开发方法。内容包括泛型与高级类型、类型推断机制、声明文件编写、模块化结构设计以及代码规范管理。通过真实项目案例分析,帮助开发者构建类型安全、结构清晰、易维护的前端工程体系,提高团队协作效率与代码质量。

49

2026.03.13

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Bootstrap 5教程
Bootstrap 5教程

共46课时 | 3.6万人学习

AngularJS教程
AngularJS教程

共24课时 | 4.2万人学习

CSS教程
CSS教程

共754课时 | 43.2万人学习

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

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