0

0

如何在Golang中实现RESTful API接口_Golang RESTful API开发实战

P粉602998670

P粉602998670

发布时间:2026-02-20 11:27:11

|

185人浏览过

|

来源于php中文网

原创

http.handlefunc 不够用因仅支持静态路径匹配,无法解析动态段如 /users/123;应选 chi 等路由库,用 chi.urlparam 安全取值,并将解析、校验、查询拆分为可测函数。

如何在golang中实现restful api接口_golang restful api开发实战

net/http 搭建最简 RESTful 路由时,为什么 http.HandleFunc 不够用?

因为 http.HandleFunc 只支持固定路径字符串匹配,无法解析 /users/123 中的 123 这类动态段。你得自己写字符串切分和类型转换,容易出错且不可维护。

实操建议:

立即学习go语言免费学习笔记(深入)”;

Android JNI开发入门与提高 中文WORD版
Android JNI开发入门与提高 中文WORD版

本文档主要讲述的是Android JNI开发入门与提高;JNI在Android系统中有着广泛的应用。Android系统底层都是C/C++实现的,上层提供的API都是Java的,Java通过JNI调用底层的实现。比如:Android API多媒体接口MediaPlayer类,其实底层通过JNI调用libmedia库。希望本文档会给有需要的朋友带来帮助;感兴趣的朋友可以过来看看

下载
  • 优先使用轻量路由库,如 gorilla/muxchi(推荐 chi,API 设计更清晰、中间件链更自然)
  • 避免手写正则匹配路径——chichi.URLParam(r, "id") 直接取值,类型安全
  • 别在 handler 里做太多逻辑,把解析、校验、DB 查询拆成独立函数,方便单元测试

chi 中如何正确处理 JSON 请求体并捕获常见解码错误?

直接 json.Decoder.Body 容易忽略 io.EOFjson.SyntaxError 等错误,导致 500 泄露内部信息或静默失败。

实操建议:

立即学习go语言免费学习笔记(深入)”;

  • 统一用封装函数解析 JSON,例如:
    func parseJSON(r *http.Request, v interface{}) error {
        defer r.Body.Close()
        if r.ContentLength == 0 {
            return errors.New("empty request body")
        }
        if err := json.NewDecoder(r.Body).Decode(v); err != nil {
            var syntaxErr *json.SyntaxError
            if errors.As(err, &syntaxErr) {
                return fmt.Errorf("invalid JSON at position %d", syntaxErr.Offset)
            }
            return fmt.Errorf("invalid request payload: %w", err)
        }
        return nil
    }
  • 在中间件中检查 Content-Type: application/json,不匹配直接返回 415
  • 结构体字段必须加 json: tag,且注意导出(首字母大写),否则解码始终为零值

RESTful 接口返回错误时,http.Error 和自定义 JSON 错误响应哪个更合适?

http.Error 返回纯文本,前端难解析;但直接写 JSON 又容易漏设 Content-Type 或状态码,导致前端收到 200 却含错误内容。

实操建议:

立即学习go语言免费学习笔记(深入)”;

  • 所有错误响应走统一函数,例如:
    func writeError(w http.ResponseWriter, status int, msg string) {
        w.Header().Set("Content-Type", "application/json; charset=utf-8")
        w.WriteHeader(status)
        json.NewEncoder(w).Encode(map[string]string{"error": msg})
    }
  • 区分错误类型:参数校验失败用 400,资源不存在用 404,权限问题用 403,服务异常用 500
  • 不要在错误响应里暴露数据库字段名、堆栈或内部路径(如 "failed to query users table"

database/sql 查询时,为什么 Scansql: no rows in result set 但接口没返回 404?

这是最常被忽略的点:rows.Scan() 本身不报这个错,真正触发它的是 rows.Err()rows.Next() 返回 false 后未检查 rows.Err()。很多开发者只判断 rows.Next() 就返回空结构体,结果 200 响应了 null。

实操建议:

立即学习go语言免费学习笔记(深入)”;

  • 查单条记录用 db.QueryRow().Scan(),它会自动返回 sql.ErrNoRows;捕获后显式返回 404
  • 查列表用 for rows.Next() 循环,循环结束后务必调 rows.Err() 判断是否有底层错误
  • 别用 _ = db.QueryRow(...).Scan(...) 忽略错误——Go 的错误必须显式处理
Gin 或 Echo 这类框架能省掉部分样板代码,但底层逻辑一致。真正容易翻车的,往往不是选什么框架,而是忘了 rows.Err()、漏了 Content-Type、或者把 json.SyntaxError 当普通错误透传给前端。

热门AI工具

更多
DeepSeek
DeepSeek

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

豆包大模型
豆包大模型

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

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

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

文心一言
文心一言

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

讯飞写作
讯飞写作

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

即梦AI
即梦AI

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

ChatGPT
ChatGPT

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

相关专题

更多
golang如何定义变量
golang如何定义变量

golang定义变量的方法:1、声明变量并赋予初始值“var age int =值”;2、声明变量但不赋初始值“var age int”;3、使用短变量声明“age :=值”等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

207

2024.02.23

golang有哪些数据转换方法
golang有哪些数据转换方法

golang数据转换方法:1、类型转换操作符;2、类型断言;3、字符串和数字之间的转换;4、JSON序列化和反序列化;5、使用标准库进行数据转换;6、使用第三方库进行数据转换;7、自定义数据转换函数。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

239

2024.02.23

golang常用库有哪些
golang常用库有哪些

golang常用库有:1、标准库;2、字符串处理库;3、网络库;4、加密库;5、压缩库;6、xml和json解析库;7、日期和时间库;8、数据库操作库;9、文件操作库;10、图像处理库。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

348

2024.02.23

golang和python的区别是什么
golang和python的区别是什么

golang和python的区别是:1、golang是一种编译型语言,而python是一种解释型语言;2、golang天生支持并发编程,而python对并发与并行的支持相对较弱等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

212

2024.03.05

golang是免费的吗
golang是免费的吗

golang是免费的。golang是google开发的一种静态强类型、编译型、并发型,并具有垃圾回收功能的开源编程语言,采用bsd开源协议。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

403

2024.05.21

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

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

344

2025.06.09

golang相关判断方法
golang相关判断方法

本专题整合了golang相关判断方法,想了解更详细的相关内容,请阅读下面的文章。

197

2025.06.10

golang数组使用方法
golang数组使用方法

本专题整合了golang数组用法,想了解更多的相关内容,请阅读专题下面的文章。

990

2025.06.17

pixiv网页版官网登录与阅读指南_pixiv官网直达入口与在线访问方法
pixiv网页版官网登录与阅读指南_pixiv官网直达入口与在线访问方法

本专题系统整理pixiv网页版官网入口及登录访问方式,涵盖官网登录页面直达路径、在线阅读入口及快速进入方法说明,帮助用户高效找到pixiv官方网站,实现便捷、安全的网页端浏览与账号登录体验。

776

2026.02.13

热门下载

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

精品课程

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

共32课时 | 5.3万人学习

Go语言实战之 GraphQL
Go语言实战之 GraphQL

共10课时 | 0.8万人学习

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

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