Golang使用GORM连接远程SQL Server默认连localhost报错排查

程序强制连接本地1433端口是因为你写的DSN格式存在致命错误，导致驱动无法正确解析填写的远程地址，自动回退到默认本地连接配置：

• 错误在远程IP前增加了http://前缀：GORM的SQL Server驱动走原生TCP协议连接数据库，不需要HTTP协议标识，加了该前缀后驱动会判定主机地址字段无效，直接使用默认的localhost:1433作为连接目标。
• 错误对整个DSN串做了url.QueryEscape转义：转义会把DSN里用于分隔用户信息、主机、参数的特殊字符（:、@、/、?等）编码成转义字符，进一步导致驱动无法解析连接配置。
• 额外语法问题：你代码里的db.AutoMigrate()没有传入任何模型结构体参数，本身不会执行任何表迁移操作，后续使用需要补全对应模型。

1. 先确认本地已经安装正确的GORM SQL Server驱动，在项目目录执行命令拉取依赖：

   go get gorm.io/driver/sqlserver
   

2. 替换原有错误的DSN写法，删除多余的http://前缀和整体转义逻辑，修正后的初始化代码如下：

   import (
   	"gorm.io/driver/sqlserver"
   	"gorm.io/gorm"
   )
   
   var DB *gorm.DB
   
   func Init() {
   	// DSN格式说明：sqlserver://[用户名]:[密码]@[远程主机IP]:[端口]?database=[目标库名]
   	// SQL Server默认端口为1433，若服务未修改自定义端口可省略端口部分
   	dsn := "sqlserver://user_log:dhhdf127ihd@11.111.1.111?database=Database_Log"
   	db, err := gorm.Open(sqlserver.Open(dsn), &gorm.Config{})
   	if err != nil {
   		panic("数据库连接失败: " + err.Error())
   	}
   	DB = db
   	
   	// 迁移表需要传入对应模型结构体指针，示例：
   	// db.AutoMigrate(&LogModel{})
   }
   

如果修正DSN后仍然无法连接，按以下顺序排查配置：

• 打开远程SQL Server所在服务器的SQL Server配置管理器，确认TCP/IP协议处于启用状态，对应监听端口配置正确
• 确认远程服务器防火墙、本地网络策略没有拦截对应SQL Server端口的出站/入站连接，本地可通过telnet命令测试端口连通性
• 如果远程SQL Server是命名实例部署，需要在DSN参数中追加实例名配置，示例：sqlserver://user_log:dhhdf127ihd@11.111.1.111?database=Database_Log&instance=你的实例名
• 确认使用的数据库账号有目标库的访问权限，没有被限制仅允许本机登录

内容的提问来源于stack exchange，提问作者Sigit Budi