0

0

如何在 Go 中实现全局自定义 404 错误页面

聖光之護

聖光之護

发布时间:2026-01-08 17:52:43

|

246人浏览过

|

来源于php中文网

原创

如何在 Go 中实现全局自定义 404 错误页面

本文介绍如何使用 go 的 `net/http` 包为所有未匹配路由统一返回自定义 404 响应,避免默认浏览器错误页,并确保 http 状态码正确设置为 404。

在 Go 的 net/http 中,http.HandleFunc 是按注册顺序精确匹配路径前缀的(注意:它不是完全等价于路由树匹配,而是基于最长前缀匹配规则)。当你只注册了 /time/ 处理器,其他路径(如 /、/times/、/whatever)将无法被任何显式注册的处理器捕获,最终由 http.DefaultServeMux 返回默认的 404 页面(即 http.Error(w, "404 page not found", http.StatusNotFound))。

要实现“仅 /time/ 正常响应,其余所有路径均返回自定义 404”,关键在于:注册一个兜底的根路径处理器 / —— 因为 / 是所有路径的公共前缀,且 http.ServeMux 会优先选择最长匹配的处理器;当没有更长匹配时,/ 就成为最终的 catch-all 处理器。

✅ 正确做法是在 main() 中添加:

http.HandleFunc("/", NotFoundHandler)

同时,务必在 NotFoundHandler 中显式写入 HTTP 状态码 404,否则客户端(如浏览器或 curl)收到的是默认的 200 OK,这不符合语义,也影响 SEO 和 API 可靠性:

B2S商城系统
B2S商城系统

B2S商城系统B2S商城系统是由佳弗网络工作室凭借专业的技术、丰富的电子商务经验在第一时刻为最流行的分享式购物(或体验式购物)推出的开源程序。开发采用PHP+MYSQL数据库,独立编译模板、代码简洁、自由修改、安全高效、数据缓存等技术的应用,使其能在大浏览量的环境下快速稳定运行,切实节约网站成本,提升形象。注意:如果安装后页面打开出现找不到数据库等错误,请删除admin下的runtime文件夹和a

下载
func NotFoundHandler(w http.ResponseWriter, r *http.Request) {
    w.WriteHeader(http.StatusNotFound) // ← 关键:设置状态码
    fmt.Fprint(w, "custom 404")
}

完整修正后的 main 函数如下:

func main() {
    version := flag.Bool("V", false, "prints current version")
    port := flag.String("port", "8080", "sets service port number")

    flag.Parse()
    if *version {
        fmt.Println(AppVersion)
        os.Exit(0)
    }

    http.HandleFunc("/time/", timeserver)
    http.HandleFunc("/", NotFoundHandler) // ← 兜底:必须放在最后(顺序无关,但语义上建议置后)

    fmt.Printf("Server starting on localhost:%s...\n", *port)
    log.Fatal(http.ListenAndServe("localhost:"+*port, nil))
}

⚠️ 注意事项:

  • 不要省略 w.WriteHeader(http.StatusNotFound):缺失会导致响应状态码为 200 OK,掩盖真实错误;
  • / 处理器必须注册,且无需额外逻辑判断路径——它天然匹配所有未被更具体路径捕获的请求;
  • 若后续需扩展路由(如 /health/、/api/),请确保它们注册在 / 之前,否则会被 / 拦截;
  • 如需更健壮的路由控制(如忽略尾部斜杠、支持变量路径),建议使用 gorilla/mux 或 chi 等第三方路由器,但对本例而言,原生 net/http 完全足够。

通过以上两步(注册 / 处理器 + 正确设状态码),你的服务即可对 所有非 /time/ 请求 统一返回语义准确、体验一致的自定义 404 响应。

相关专题

更多
curl_exec
curl_exec

curl_exec函数是PHP cURL函数列表中的一种,它的功能是执行一个cURL会话。给大家总结了一下php curl_exec函数的一些用法实例,这个函数应该在初始化一个cURL会话并且全部的选项都被设置后被调用。他的返回值成功时返回TRUE, 或者在失败时返回FALSE。

425

2023.06.14

linux常见下载安装工具
linux常见下载安装工具

linux常见下载安装工具有APT、YUM、DNF、Snapcraft、Flatpak、AppImage、Wget、Curl等。想了解更多linux常见下载安装工具相关内容,可以阅读本专题下面的文章。

174

2023.10.30

scripterror怎么解决
scripterror怎么解决

scripterror的解决办法有检查语法、文件路径、检查网络连接、浏览器兼容性、使用try-catch语句、使用开发者工具进行调试、更新浏览器和JavaScript库或寻求专业帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

186

2023.10.18

500error怎么解决
500error怎么解决

500error的解决办法有检查服务器日志、检查代码、检查服务器配置、更新软件版本、重新启动服务、调试代码和寻求帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

271

2023.10.25

http500解决方法
http500解决方法

http500解决方法有检查服务器日志、检查代码错误、检查服务器配置、检查文件和目录权限、检查资源不足、更新软件版本、重启服务器或寻求专业帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

311

2023.11.09

http请求415错误怎么解决
http请求415错误怎么解决

解决方法:1、检查请求头中的Content-Type;2、检查请求体中的数据格式;3、使用适当的编码格式;4、使用适当的请求方法;5、检查服务器端的支持情况。更多http请求415错误怎么解决的相关内容,可以阅读下面的文章。

396

2023.11.14

HTTP 503错误解决方法
HTTP 503错误解决方法

HTTP 503错误表示服务器暂时无法处理请求。想了解更多http错误代码的相关内容,可以阅读本专题下面的文章。

1440

2024.03.12

http与https有哪些区别
http与https有哪些区别

http与https的区别:1、协议安全性;2、连接方式;3、证书管理;4、连接状态;5、端口号;6、资源消耗;7、兼容性。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

1862

2024.08.16

Golang 分布式缓存与高可用架构
Golang 分布式缓存与高可用架构

本专题系统讲解 Golang 在分布式缓存与高可用系统中的应用,涵盖缓存设计原理、Redis/Etcd集成、数据一致性与过期策略、分布式锁、缓存穿透/雪崩/击穿解决方案,以及高可用架构设计。通过实战案例,帮助开发者掌握 如何使用 Go 构建稳定、高性能的分布式缓存系统,提升大型系统的响应速度与可靠性。

58

2026.01.09

热门下载

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

相关下载

更多

精品课程

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

共32课时 | 3.5万人学习

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号