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 解析器会直接报错。

❌ 错误认知示例:

剪映专业版
剪映专业版

一款全能易用的桌面端剪辑软件

下载
  • 认为 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 等)直接解析的响应。

相关专题

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

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

673

2023.10.12

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

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

319

2023.10.27

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

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

344

2024.02.23

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

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

1082

2024.03.06

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

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

355

2024.03.06

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

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

671

2024.04.07

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

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

563

2024.04.29

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

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

406

2024.04.29

虚拟号码教程汇总
虚拟号码教程汇总

本专题整合了虚拟号码接收验证码相关教程,阅读下面的文章了解更多详细操作。

25

2025.12.25

热门下载

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

精品课程

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

共46课时 | 2.6万人学习

AngularJS教程
AngularJS教程

共24课时 | 2万人学习

CSS教程
CSS教程

共754课时 | 16.5万人学习

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

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