mirror of
https://github.com/Syngnat/GoNavi.git
synced 2026-05-12 05:09:41 +08:00
72811092b4
- MariaDB：MySQL驱动占位，默认端口3306，归类关系型数据库 - Vastbase（海量）：PG驱动占位，默认端口5432，归类国产数据库 - HighGo（瀚高）：PG驱动，支持SM3认证扩展，归类国产数据库 - MongoDB：官方驱动实现，归类NoSQL - SQL Server：微软官方驱动实现，归类关系型数据库 - ConnectionModal 新增数据源选项卡与默认端口配置 - database.go 新增5种类型的实例化分支 - 同步更新 db_context、methods_db、sql_sanitize、methods_file、sql_helpers 类型判断 - 新增 HighGo SM3 驱动集成指南
180 lines
4.1 KiB
Markdown
180 lines
4.1 KiB
Markdown
# HighGo SM3 国密驱动集成指南
|
||
|
||
## 一、背景说明
|
||
|
||
HighGo（瀚高）数据库需要使用支持 SM3 国密认证的 PostgreSQL 驱动。瀚高官方提供了基于 `lib/pq` 的安全增强版本。
|
||
|
||
## 二、集成步骤
|
||
|
||
### 步骤 1：下载瀚高 pq 驱动
|
||
|
||
1. 访问百度网盘链接：
|
||
```
|
||
https://pan.baidu.com/s/1xuz6uJz0utRgKWecXhpOiA?pwd=o0tj
|
||
```
|
||
|
||
2. 下载驱动源码压缩包
|
||
|
||
### 步骤 2：放置驱动源码
|
||
|
||
1. 在项目根目录创建 vendor 目录（如果不存在）：
|
||
```bash
|
||
mkdir -p vendor/highgo-pq
|
||
```
|
||
|
||
2. 解压下载的驱动源码到 `vendor/highgo-pq/` 目录
|
||
|
||
3. 确保目录结构如下：
|
||
```
|
||
GoNavi/
|
||
├── vendor/
|
||
│ └── highgo-pq/
|
||
│ ├── go.mod
|
||
│ ├── conn.go
|
||
│ ├── ... (其他 pq 驱动源文件)
|
||
```
|
||
|
||
### 步骤 3：修改 go.mod
|
||
|
||
在 `go.mod` 文件末尾添加 replace 指令：
|
||
|
||
```go
|
||
replace github.com/lib/pq => ./vendor/highgo-pq
|
||
```
|
||
|
||
完整示例：
|
||
```go
|
||
module GoNavi-Wails
|
||
|
||
go 1.24.3
|
||
|
||
require (
|
||
// ... 现有依赖
|
||
github.com/lib/pq v1.11.1
|
||
// ... 其他依赖
|
||
)
|
||
|
||
// 在文件末尾添加
|
||
replace github.com/lib/pq => ./vendor/highgo-pq
|
||
```
|
||
|
||
### 步骤 4：更新 HighGo 连接配置（可选）
|
||
|
||
根据瀚高官方文档，建议修改 `internal/db/highgo_impl.go:43` 的 sslmode：
|
||
|
||
**当前代码**：
|
||
```go
|
||
q.Set("sslmode", "disable")
|
||
```
|
||
|
||
**建议修改为**（瀚高默认）：
|
||
```go
|
||
q.Set("sslmode", "require")
|
||
```
|
||
|
||
> ⚠️ 注意：如果您的 HighGo 服务器未配置 SSL，保持 `disable` 即可。
|
||
|
||
### 步骤 5：验证集成
|
||
|
||
1. 清理依赖缓存：
|
||
```bash
|
||
go clean -modcache
|
||
```
|
||
|
||
2. 重新下载依赖：
|
||
```bash
|
||
go mod download
|
||
```
|
||
|
||
3. 编译项目：
|
||
```bash
|
||
go build ./...
|
||
```
|
||
|
||
4. 测试 HighGo 连接：
|
||
- 启动应用
|
||
- 创建 HighGo 连接
|
||
- 测试连接是否成功
|
||
|
||
## 三、重要说明
|
||
|
||
### ⚠️ 影响范围
|
||
|
||
使用 `go.mod replace` 会**全局替换** `github.com/lib/pq` 驱动，这意味着：
|
||
|
||
1. **PostgreSQL 连接也会使用瀚高驱动**
|
||
2. **需要验证瀚高驱动对标准 PostgreSQL 的兼容性**
|
||
|
||
### 兼容性验证
|
||
|
||
集成后，请务必测试：
|
||
|
||
1. ✅ HighGo 数据库连接（SM3 认证）
|
||
2. ✅ 标准 PostgreSQL 连接（确保仍然可用）
|
||
|
||
如果标准 PostgreSQL 连接失败，说明瀚高驱动不完全兼容，需要考虑其他方案。
|
||
|
||
### 回滚方案
|
||
|
||
如果集成后出现问题，可以快速回滚：
|
||
|
||
1. 删除 `go.mod` 中的 replace 指令
|
||
2. 删除 `vendor/highgo-pq/` 目录
|
||
3. 运行 `go mod tidy`
|
||
4. 重新编译
|
||
|
||
## 四、瀚高驱动特性
|
||
|
||
根据官方文档：
|
||
|
||
- **包路径**：`github.com/lib/pq`（与标准版相同）
|
||
- **驱动名**：`postgres`（与标准版相同）
|
||
- **SM3 支持**：自动启用国密认证
|
||
- **默认端口**：5866
|
||
- **默认数据库**：`highgo`
|
||
- **默认用户**：`sysdba`
|
||
- **sslmode 默认**：`require`
|
||
|
||
## 五、故障排查
|
||
|
||
### 问题 1：编译失败
|
||
|
||
**现象**：`go build` 报错找不到 `github.com/lib/pq`
|
||
|
||
**解决**：
|
||
1. 检查 `vendor/highgo-pq/` 目录是否存在
|
||
2. 检查 `go.mod` 中 replace 路径是否正确
|
||
3. 运行 `go mod download`
|
||
|
||
### 问题 2：HighGo 连接失败
|
||
|
||
**现象**：连接 HighGo 时报认证错误
|
||
|
||
**解决**：
|
||
1. 确认瀚高驱动已正确替换（检查 `go.mod`）
|
||
2. 确认 HighGo 服务器支持 SM3 认证
|
||
3. 检查用户名、密码、端口是否正确
|
||
|
||
### 问题 3：PostgreSQL 连接失败
|
||
|
||
**现象**：集成后标准 PostgreSQL 无法连接
|
||
|
||
**解决**：
|
||
1. 这说明瀚高驱动不完全兼容标准 PostgreSQL
|
||
2. 需要考虑条件编译或其他隔离方案
|
||
3. 临时回滚：删除 replace 指令
|
||
|
||
## 六、后续优化建议
|
||
|
||
如果发现瀚高驱动与标准 PostgreSQL 不兼容，可以考虑：
|
||
|
||
1. **条件编译**：使用 Go build tags 分别编译两个版本
|
||
2. **动态驱动注册**：如果瀚高驱动支持自定义驱动名
|
||
3. **联系瀚高技术支持**：咨询官方兼容性方案
|
||
|
||
## 七、参考资料
|
||
|
||
- 瀚高官方文档：https://www.highgo.com/document/zh-cn/application/pq%E6%8E%A5%E5%8F%A3.html
|
||
- 瀚高驱动下载：https://pan.baidu.com/s/1xuz6uJz0utRgKWecXhpOiA?pwd=o0tj
|
||
- 标准 lib/pq：https://github.com/lib/pq
|