JSON 解析错误:字符串无法解码为结构体类型的原因与解决方案

夏伟同学_1375

夏伟同学_1375

2026-09-29

698人浏览

原创

JSON 解析错误:字符串无法解码为结构体类型的原因与解决方案

本文解析 Go 中 json: cannot unmarshal string into Go value of type main.test_struct 错误的根源——前端以 application/x-www-form-urlencoded 方式提交表单数据,而非 JSON 格式,导致 Go 的 json.Decoder 尝试将 URL 编码字符串解析为结构体时失败。

本文解析 go 中 `json: cannot unmarshal string into go value of type main.test_struct` 错误的根源——前端以 `application/x-www-form-urlencoded` 方式提交表单数据,而非 json 格式,导致 go 的 `json.decoder` 尝试将 url 编码字符串解析为结构体时失败。

该错误并非 Go 结构体定义或 JSON 标签问题,而是数据传输格式不匹配所致。从您提供的前端代码可见,jQuery 的 $.ajax() 在 data 传入对象(如 {long: long, lat: lat})且未显式指定 contentType 时,会自动将其序列化为 application/x-www-form-urlencoded 格式的键值对(例如 lat=48.892423&lng=2.215331),而非 JSON 字符串。而您的 Go 后端却使用 json.NewDecoder(r.Body).Decode(&t) 强制按 JSON 协议解析——这相当于用 JSON 解析器去读取一段 URL 编码文本,自然触发 cannot unmarshal string into Go value of type ... 错误(底层实际是尝试把 "lat=48.89..." 这个字符串整体赋给 test_struct 类型变量,类型严重不匹配)。

✅ 正确做法:前后端格式必须一致

方案一(推荐):前端发送标准 JSON,后端保持 JSON 解析

修改 JavaScript,显式设置 contentType: "application/json" 并手动序列化数据:

// 前端:发送 JSON 格式
var params = { lat: lat, lng: lng, acc: 1962 }; // 注意字段名需与 Go struct tag 一致
$.ajax({
    type: 'POST',
    url: 'http://localhost:9280/post_geo/',
    contentType: 'application/json', // 关键:声明内容类型
    data: JSON.stringify(params),     // 关键:序列化为 JSON 字符串
    success: function(data2) {
        console.log(data2);
    }
});

Go 后端无需修改(但建议补充错误处理与 r.Body.Close()):

Aria2 Json Rpc
Aria2 Json Rpc

通过 JSON‑RPC 2.0 与 aria2 下载管理器交互,使用自然语言命令管理下载、查询状态并控制任务。适用于 aria2、下载管理或种子操作。

下载
func postGeo(w http.ResponseWriter, r *http.Request) {
    var t struct {
        Lat float32 `json:"lat"`
        Lng float32 `json:"lng"`
        Acc int     `json:"acc"`
    }

    if err := json.NewDecoder(r.Body).Decode(&t); err != nil {
        http.Error(w, "Invalid JSON: "+err.Error(), http.StatusBadRequest)
        return
    }
    defer r.Body.Close() // 必须关闭 Body

    Info.Printf("Received: %+v", t)
    w.Header().Set("Access-Control-Allow-Origin", "*")
    fmt.Fprintf(w, "OK")
}

方案二:后端适配表单数据(兼容旧逻辑)

若无法修改前端,可改用 r.ParseForm() 解析 x-www-form-urlencoded 数据:

func postGeo(w http.ResponseWriter, r *http.Request) {
    if err := r.ParseForm(); err != nil {
        http.Error(w, "Parse form failed", http.StatusBadRequest)
        return
    }

    lat, _ := strconv.ParseFloat(r.FormValue("lat"), 32)
    lng, _ := strconv.ParseFloat(r.FormValue("lng"), 32)
    acc, _ := strconv.Atoi(r.FormValue("acc"))

    t := struct {
        Lat float32
        Lng float32
        Acc int
    }{
        Lat: float32(lat),
        Lng: float32(lng),
        Acc: acc,
    }

    Info.Printf("Parsed form: %+v", t)
    w.Header().Set("Access-Control-Allow-Origin", "*")
    fmt.Fprintf(w, "OK")
}

⚠️ 注意事项

  • 永远检查 r.Body.Close():即使使用 json.Decoder,也应在 defer 或显式位置关闭 r.Body,避免连接泄漏。
  • 禁止在解析前多次读取 r.Body:r.Body 是单次读取流,ioutil.ReadAll(r.Body) 后再调用 json.Decode() 会读到空内容。
  • 跨域请求(CORS)与 JSONP 冲突:您当前前端同时设置了 crossDomain: true 和 dataType: 'jsonp',但 JSONP 仅支持 GET 请求,无法用于 POST;且后端未提供 JSONP 回调包装,会导致请求失败。建议统一使用 CORS(服务端设置 Access-Control-Allow-Origin 等头)替代 JSONP。

通过确保“前端发送什么格式,后端就用对应方式解析”,即可彻底解决该类反序列化错误。

相关文章

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

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

下载

相关标签:

js json

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

相关专题

更多
golang结构体相关大全
golang结构体相关大全

本专题整合了golang结构体相关大全,想了解更多内容,请阅读专题下面的文章。

2025.06.09

4054

18

golang结构体方法
golang结构体方法

本专题整合了golang结构体相关内容,请阅读专题下面的文章了解更多。

2025.07.04

4231

25

Go中Type关键字的用法
Go中Type关键字的用法

Go中Type关键字的用法有定义新的类型别名或者创建新的结构体类型。本专题为大家提供Go相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.06

2389

5

go怎么实现链表
go怎么实现链表

go通过定义一个节点结构体、定义一个链表结构体、定义一些方法来操作链表、实现一个方法来删除链表中的一个节点和实现一个方法来打印链表中的所有节点的方法实现链表。

2023.09.25

4687

6

go语言编程软件有哪些
go语言编程软件有哪些

go语言编程软件有Go编译器、Go开发环境、Go包管理器、Go测试框架、Go文档生成器、Go代码质量工具和Go性能分析工具等。本专题为大家提供go语言相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.13

622

5

0基础如何学go语言
0基础如何学go语言

0基础学习Go语言需要分阶段进行,从基础知识到实践项目,逐步深入。php中文网给大家带来了go语言相关的教程以及文章,欢迎大家前来学习。

2023.10.26

6465

20

Go语言实现运算符重载有哪些方法
Go语言实现运算符重载有哪些方法

Go语言不支持运算符重载,但可以通过一些方法来模拟运算符重载的效果。使用函数重载来模拟运算符重载,可以为不同的类型定义不同的函数,以实现类似运算符重载的效果,通过函数重载,可以为不同的类型实现不同的操作。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

2216

5

Go语言中的运算符有哪些
Go语言中的运算符有哪些

Go语言中的运算符有:1、加法运算符;2、减法运算符;3、乘法运算符;4、除法运算符;5、取余运算符;6、比较运算符;7、位运算符;8、按位与运算符;9、按位或运算符;10、按位异或运算符等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

2444

5

go语言开发工具大全
go语言开发工具大全

本专题整合了go语言开发工具大全,想了解更多相关详细内容,请阅读下面的文章。

2025.06.11

5379

12

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WEB前端教程【HTML5+CSS3+JS】
WEB前端教程【HTML5+CSS3+JS】

共101课时 | 20.6万人学习

JS进阶与BootStrap学习
JS进阶与BootStrap学习

共39课时 | 4.7万人学习