supertokens在go微服务中无法直接使用官方sdk，需手动对接其core后端api，自行处理session cookie校验、jwt解析及请求头透传，并通过/recipe/session/verify等接口完成认证与刷新流程。
SuperTokens 在 Go 微服务里不能直接用官方 SDK
SuperTokens 官方只提供 Node.js、Next.js、React、Vue 等前端/全栈 SDK，go 语言没有官方客户端库。这意味着你无法像在 Express 里调用 supertokens.init() 那样初始化——所有认证流程必须手动对接其后端 API（即 SuperTokens Core），并自行处理 session cookie、JWT 解析、请求头透传等细节。
实际做法是：让 Go 服务作为「反向代理 + 认证网关」或「纯 API 客户端」，把登录/注册/刷新等操作转发给独立部署的 SuperTokens Core（默认监听 http://localhost:3544），再解析响应、校验 session token、提取用户 ID。
必须自己实现 session cookie 的解析与校验
SuperTokens 的 session cookie（supertokens-session）是加密签名的，Go 里没法直接解密验证。正确路径是：用 Go 发起 POST /recipe/session/verify 请求到 SuperTokens Core，把 cookie 值作为 cookie 字段提交，由 Core 返回 { "status": "OK", "userId": "..." } 或错误。
- 不要尝试用
http.Request.Cookies()拿到值就直接 base64 解码——它不是标准 JWT，也不是简单编码 - 每次需要鉴权的接口（如
/api/profile）都得先调一次/recipe/session/verify，延迟叠加明显，建议加一层本地缓存（如userId → expiry的 map + TTL） - 务必检查响应中的
status字段：只有"OK"才算通过；"INVALID_CLAIMS"或"SESSION_EXPIRED"要返回401
跨域和 cookie 传递容易出错
Go 服务和 SuperTokens Core 通常部署在不同域名下（比如 Go 是 api.example.com，Core 是 auth.example.com），这时浏览器不会自动携带 supertokens-session cookie 到 Go 后端，导致 /recipe/session/verify 总是失败。
解决方案只有两个：
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 前端发请求时显式带上
Credentials: 'include'，且 Go 服务的 CORS 中必须设置Access-Control-Allow-Credentials: true和明确的Access-Control-Allow-Origin（不能用*） - 更推荐的方式：让 Go 服务统一作为反向代理（例如用
gorilla/handlers.ProxyHandler），把/auth/*路径代理到 SuperTokens Core，并确保 proxy 透传 cookie（设置Director修改req.Header中的Cookie和Origin）
漏掉任一环，都会看到 Invalid session token 或空 userId。
refresh API 必须手动触发，且需处理 401 重定向逻辑
SuperTokens 的 refresh 流程不是静默后台完成的。当 session 即将过期，前端必须主动调用 /recipe/session/refresh，而 Go 服务如果作为中间层，就得在收到该请求时，原样转发给 Core，并把响应头里的新 Set-Cookie 透传回浏览器。
关键点：
- Go 的
http.Transport默认不转发Set-Cookie头，需手动复制：resp.Header["Set-Cookie"] = proxyResp.Header["Set-Cookie"] - 若 refresh 失败（比如返回
401），Go 层不能吞掉，要原样返回状态码和 body，否则前端无法跳转登录页 - 不要在 Go 里自己生成新 session —— SuperTokens Core 控制所有 session 生命周期，任何绕过它的操作都会导致状态不一致
真正麻烦的不是代码量，而是每个环节都要和 SuperTokens Core 的 HTTP 协议对齐：路径、header、body 结构、错误码含义，差一个字段就卡住。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
