先查端口和权限，90%连不上是服务未启动或IDE无访问权限；PostgreSQL需验证pg_isready并注意localhost/127.0.0.1解析差异，SQLite须用绝对路径、_mutex=no及db.Close()防锁和泄漏。
GoLand里连不上SQLite或PostgreSQL本地实例？先查端口和权限
本地数据库连不上，90%不是代码问题，而是服务根本没起来，或者IDE没拿到访问权限。GoLand默认不继承终端的环境变量，psql能连不代表Go代码能连——它可能压根没读到PGHOST或PGPORT。macOS上尤其要注意：PostgreSQL通过Homebrew安装后，默认监听的是localhost而非127.0.0.1，而某些驱动（比如pgx）在解析连接字符串时对这两者行为不一致；SQLite则常见于路径权限错误——比如你用./data/app.db，但GoLand运行测试时工作目录是项目根，而文件实际在testdata/下。
SQLite：用file://绝对路径 + _mutex=no避免并发冲突
SQLite适合单测和轻量开发，但GoLand默认并行跑测试（go test -p=4），多个TestXXX函数同时打开同一个db文件会触发“database is locked”错误。解决方式不是加锁，而是让每个测试用独立文件，或显式禁用互斥：
- 用
filepath.Abs("testdata/test.db")生成绝对路径，避免相对路径解析错位 - 连接字符串末尾加上
?_mutex=no（仅限mattn/go-sqlite3驱动），绕过默认的WAL锁机制 - 测试结束必须
db.Close()，否则文件句柄泄漏，下次测试可能报“too many open files”
PostgreSQL本地实例：别硬写localhost:5432，用pg_isready验证再连
硬编码host=localhost port=5432在CI或Docker环境必挂。即使本地跑，也建议在TestMain里加一层探测：
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 启动测试前执行
pg_isready -h localhost -p 5432 -U postgres -t 5，超时就跳过测试或报错 - 连接字符串用
postgres://postgres:password@localhost:5432/testdb?sslmode=disable，其中testdb需提前用createdb testdb建好 - 如果用Docker跑PostgreSQL（如
docker run --rm -p 5432:5432 -e POSTGRES_PASSWORD=password -d postgres），注意Windows/macOS上localhost指向Docker虚拟机，不是宿主机，此时应改用host.docker.internal（Docker Desktop支持）
GoLand运行配置里漏了GOPATH或GOBIN？数据库驱动编译会静默失败
用github.com/lib/pq或github.com/jackc/pgx时，如果GoLand的Run Configuration里没正确继承GOPATH，go build阶段可能找不到cgo依赖，但错误被吞掉，只显示“connection refused”。检查点：
- 进
Run → Edit Configurations → Go Build，确认Environment variables里有GOPATH（哪怕只是$HOME/go） - 如果驱动含C代码（如
mattn/go-sqlite3），确保CGO_ENABLED=1已设，且系统装了gcc或clang - macOS上若用ARM芯片，
libpq需从Homebrew重装：brew install libpq && brew link --force libpq，否则ld: library not found for -lpq
最常被忽略的是：本地数据库服务本身是否随系统开机自启。PostgreSQL在macOS上用Homebrew安装后默认不自启，每次重启机器都要手动brew services start postgresql；SQLite虽无服务概念，但文件路径写错、目录不存在、权限为只读，都会导致os.OpenFile返回permission denied而非更明确的错误。这些细节不验证，光调代码等于在黑盒里拧螺丝。
