gorm v2 中 sql server 连接字符串必须为 odbc 风格，格式为 server=host;user id=user;password=pass;database=name；须调用 sqlserver.open(dsn) 包装，不可直接传字符串或使用 sqlserver:// 前缀，否则报 failed to parse dsn 或 unsupported driver。
SQL Server 连接字符串（DSN）怎么写才有效
直接用 sqlserver:// 前缀的 DSN 在 GORM v2 中会报错：failed to parse dsn。GORM v2 的 SQL Server 驱动不接受 URL 形式，必须改用 ODBC 风格的连接字符串。
正确格式是：server=host;user id=user;password=pass;port=1433;database=name
- 不能省略
server=、user id=、password=、database=四个关键项 -
port可选，但显式写出更稳妥（尤其非默认 1433 端口时） - 如果 SQL Server 启用了 Windows 身份验证，需改用
trusted_connection=yes并去掉user id和password - 连接字符串中不要加空格或换行，否则
sqlserver.Open()解析失败
gorm.Open 时必须用 sqlserver.Open()，不能传字符串
GORM v2 不再支持像旧版那样传数据库类型名（如 "mssql"）或直接传 DSN 字符串。必须显式调用驱动包的 sqlserver.Open() 函数。
常见错误写法：gorm.Open("sqlserver", dsn) 或 gorm.Open(dsn, ...) —— 都会 panic。
- 导入驱动：
"gorm.io/driver/sqlserver"（不是github.com/jinzhu/gorm/dialects/mssql，那是 v1 的） - 调用方式：
gorm.Open(sqlserver.Open(dsn), &gorm.Config{}) - 如果漏掉
sqlserver.Open()这层包装，gorm.Open会认为你传的是 driver name，找不到对应驱动而报unsupported driver
SQL Server 的 TOP 语法和 LIMIT 冲突怎么处理
GORM 默认生成的 LIMIT 语句在 SQL Server 上无效，执行 db.Limit(10).Find(&v) 会直接报错：Incorrect syntax near 'LIMIT'。
必须手动改写为 SQL Server 兼容形式：
- 用
Select("TOP 10 *")替代Limit(10) - 排序必须显式写
Order("id DESC")，否则TOP行为不可预测 - 分页推荐用
Offset().Limit()组合，GORM v2 会自动转成OFFSET ... ROWS FETCH NEXT ... ROWS ONLY（SQL Server 2012+） - 若用老版本 SQL Server（ROW_NUMBER()，GORM 不自动降级适配
连接池和超时参数容易被忽略的点
SQL Server 对空闲连接更敏感，不配置连接池参数容易出现 read tcp: i/o timeout 或连接堆积。
- 务必设置
sqlserver.Config{ConnMaxLifetime: 30 * time.Second}，避免连接复用过久失效 - 通过
db.DB().SetMaxOpenConns(20)和db.DB().SetMaxIdleConns(10)主动控制底层*sql.DB行为 - DSN 中加
connection timeout=5（单位秒），防止网络抖动时卡死在Open() - 首次
db.First()才真正建连，所以健康检查不能只靠gorm.Open是否返回 err，要加db.Exec("SELECT 1").Error
GORM 连 SQL Server 最容易栽在 DSN 格式和驱动调用方式上，这两处错一个就完全连不上；而 TOP/LIMIT 和连接池问题，则往往在线上跑一阵后才暴露。
