Gin服务无缝平滑升级的核心是新旧逻辑共存、旧路径不中断、连接不丢、事务不破；需通过endless（或graceful/http.Server.Shutdown）、路由别名、router.Any映射及atomic.Value封装数据库连接池实现。
Gin 服务的无缝平滑升级，核心不是“换二进制”，而是让新旧逻辑共存、旧路径不中断、连接不丢、事务不破——所有方案都围绕这三点展开，选错方式会直接触发 sql: database is closed 或 HTTP 500。
用 endless 实现零停机重启（适合二进制替换场景）
它通过 fork 子进程 + 文件描述符继承实现真正的连接不丢，老进程等存量请求自然结束，新进程接管新连接。但注意：endless 已归档，生产环境建议改用更活跃的替代品如 graceful 或原生 http.Server.Shutdown 配合信号监听。
- 必须用
kill -1 $PID（SIGHUP）触发重启，kill -9会跳过优雅流程 - 编译新二进制前，确保旧进程仍在运行；否则新进程无法继承监听 socket
-
endless.ListenAndServe启动后，netstat -tuln | grep :8080应始终看到同一端口被监听，且 PID 不变（实际是父进程 PID） - 若使用 Docker，需配置
--init或TINI作为 PID 1，否则子进程可能收不到信号
用 router.Group + 共享 handler 实现路由别名（适合路径迁移）
当你要把 /api/v1/users 迁移到 /api/v2/users，但旧客户端还大量存在时，别重定向，直接复用 handler。
- 新建
router.Group("/api/v1/users")，在其中调用GET("", userListHandler)，和/api/v2/users用同一个userListHandler函数 - 中间件必须显式复用：如果
v2路径用了authMiddleware，v1Group 也得group.Use(authMiddleware)，否则权限逻辑断裂 - 禁止在 handler 里硬编码路径判断，比如
if c.Request.URL.Path == "/api/v1/users"—— 这会让别名失去意义，且难测试 - 上线后加
logOldPathUsage中间件，统计/api/v1/users的调用量，下降到阈值后再下线
用 router.Any 拦截 + 手动调用 handler（适合结构差异大的路径映射）
当旧路径 /users/list 和新路径 /api/users 完全不对齐，Group 前缀无法复用时，用 Any 拦截并透传上下文。
Colly Golang Web Scraper and Crawler Framework
下载
Colly 是一个用于 Go 语言的快速开源爬取和爬虫框架。它适用于从简单的页面提取到异步爬虫处理大量页面集合，支持请求回调和结构化解析。
立即学习“go语言免费学习笔记（深入）”；
-
c.Request.URL.Path = "/api/users"必须写在 handler 开头，且不能依赖 Gin 自动重匹配 —— Gin 不会重新走路由表 - 目标 handler（如
userAPIGetHandler）必须是函数变量，不能是匿名函数，否则无法复用 - 禁止修改
c.Request.Method后调c.Next()或c.Redirect，这会触发真实重定向或 panic - POST/PUT 请求体无需额外处理：
c.Request.Body保持原样，直接传给目标 handler 即可
数据库连接池切换必须渐进，不能 Close() 就完事
所有 handler 都在用 *sql.DB，但连接池本身不是线程安全可原子替换的对象。直接 db.Close() 会导致正在执行的 db.Query 报 sql: database is closed。
- 用
atomic.Value封装当前生效的*sql.DB，所有业务代码通过GetDB()获取实例 - 新连接池启动后先
db.PingContext()，再atomic.StorePointer()切换指针 - 旧连接池调
SetMaxOpenConns(0)和SetMaxIdleConns(0)，阻止新连接分配，只等InUse == 0后再Close() - 事务
db.Begin()返回的*sql.Tx绑定旧池，升级窗口期内禁止新开事务，可用全局upgrading.Load()拦截
真正容易被忽略的是：路由别名和连接池切换是两层事，前者管 HTTP 层语义连续性，后者管数据层状态连续性。漏掉任何一层，都会在流量高峰时暴露为偶发 500 或连接中断。监控旧路径调用量和 db.Stats().InUse 必须同步做，不能只看日志。
