go网关控制台空白主因是config.json 404，需检查静态路由配置与文件路径；字段解析失败因json tag缺失；热更新需阻塞main goroutine；cors预检需显式处理options。
Go 网关控制台配置页面加载后空白，config.json 404 是最常见原因
前端请求 /api/config 拉配置时失败，页面没报错但啥都不显示——八成是后端没把 config.json 文件放到静态服务路径下。Gin/echo 默认不自动提供根目录文件，得手动注册静态路由或用 embed.FS 嵌入。
- 检查
main.go是否调用了router.StaticFS("/static", http.FS(yourFS))，且config.json在对应路径里 - 用
go:embed更稳妥：声明var configFS embed.FS，然后http.FS(configFS)传给StaticFS - 别把
config.json放在./assets却配了Static("./static")——路径对不上，404 不会提示你缺哪级目录
前端读取的 config.json 字段和 Go 后端结构体字段名不一致，导致解析为空
JSON 键名默认按 Go struct 字段名转小写匹配，比如 ListenAddr 对应 listenaddr，但前端写的是 listenAddr（驼峰），后端又没加 json:"listenAddr" 标签，就直接丢弃该字段。
- 后端 struct 每个字段必须显式加
jsontag，尤其含大小写的字段：ListenAddr string `json:"listenAddr"` - 前端改字段名不如后端加 tag 稳定；一旦 JSON schema 变动，前后端要同步改，tag 是唯一契约点
- 用
json.Unmarshal后立刻打印fmt.Printf("%+v", cfg)，确认字段是否为零值——这是判断解析失败的第一步
配置热更新时 os.Signal 未阻塞主 goroutine，导致程序秒退
想监听 SIGHUP 重载配置，但 main 函数执行完就退出，信号根本收不到。这不是信号没注册成功，而是 Go 程序生命周期结束了。
- 必须在
main()末尾加select{}或signal.Notify(signalChan, syscall.SIGHUP)后保持主 goroutine 运行 - 别在 goroutine 里起信号监听还忘了
sync.WaitGroup或chan阻塞——main 一结束，所有 goroutine 被强制终止 - 热更新逻辑里，新配置校验失败时别直接 panic，应记录 error 并保留旧配置；否则一次错误配置会让网关彻底不可用
Vue 前端表单提交后，PUT /api/config 返回 405，其实是 Gin 路由没开 OPTIONS
CORS 预检失败时浏览器只报 405 Method Not Allowed，但真正原因是没处理 OPTIONS 请求。Gin 默认不自动响应预检，需要显式注册或用中间件。
立即学习“go语言免费学习笔记（深入）”；
- 手动加路由：
router.OPTIONS("/api/config", corsHandler)，其中corsHandler只需c.Header("Access-Control-Allow-Methods", "PUT,GET")等基础头 - 更省事：用
github.com/rs/cors中间件，但注意它默认不放行Content-Type: application/json，得显式配置AllowedHeaders - 别在 Nginx 层做 CORS 而忽略 Go 后端——如果前端直连 Go 服务（开发时常见），Nginx 根本没参与这次请求
