总结：Go程序在Docker中的构建与依赖管理

一、多阶段构建优化

1. 构建阶段：

   • 使用官方 golang:1.24.2 镜像，确保构建环境一致性。
   • 启用 CGO (CGO_ENABLED=1) 以支持依赖C库的功能（如 go-sqlite3）。
   • 设置 GOPROXY 加速模块下载（如 https://goproxy.cn,direct）。

2. 运行阶段：

   • 使用轻量级带 glibc 的镜像（如 frolvlad/alpine-glibc），替代标准 Alpine（musl libc）。
   • 仅拷贝构建产物（COPY --from=builder），减少镜像体积。
   • 安装运行时依赖（如 sqlite-libs）。

二、动态链接与依赖管理

1. CGO启用的条件：

   • 需要动态链接：当使用 CGO_ENABLED=1 且依赖 C 库（如 go-sqlite3、net、os/user）时，二进制会依赖 glibc（路径 /lib64/ld-linux-x86-64.so.2）。
   • 静态编译优势：若 CGO_ENABLED=0，Go 会静态链接所有依赖，无需系统库支持，兼容性更佳。

2. 依赖库安装：

   • Alpine 系镜像：需通过 apk add --no-cache sqlite-libs 安装动态库。
   • Debian/Ubuntu 系镜像：需通过 apt-get install -y libsqlite3-0 安装。

   • 是否需要安装？

     • 若使用 github.com/mattn/go-sqlite3（CGO 实现），必须安装对应库。
     • 若使用纯 Go 实现（如 modernc.org/sqlite），可省略。

三、基础镜像选择

四、依赖库诊断方法

1. ldd 命令：

   • 检查二进制是否动态链接：ldd ./myapp
   • 输出示例：libsqlite3.so.0 => /usr/lib/libsqlite3.so.0 表示需安装对应库。
   • 若提示 "not a dynamic executable"，则为静态编译。

2. file 命令：

   • 查看链接类型：file ./myapp
   • 输出示例：ELF 64-bit LSB executable, dynamically linked 表示动态链接。

3. readelf 或 objdump：

   • 详细依赖分析：readelf -d ./myapp 或 objdump -p ./myapp。

五、最佳实践

1. 优先静态编译：

   • 减少依赖，提升镜像安全性与兼容性。
   • 示例：CGO_ENABLED=0 go build -o myapp。

2. 按需选择镜像：

   • 如需 CGO，使用 alpine-glibc 并安装必要库。
   • 否则使用 alpine 或 scratch 极简镜像。

3. 避免常见错误：

   • 在 musl libc（Alpine）中运行 glibc 依赖程序 → 崩溃。
   • 忽略动态库安装（如 sqlite-libs）→ 运行时报错 libsqlite3.so.0 not found。

六、典型 Dockerfile 示例

# 构建阶段
FROM golang:1.24.2 AS builder
WORKDIR /app
COPY . .
ENV GOPROXY=https://goproxy.cn,direct
RUN go mod tidy && \
    CGO_ENABLED=1 go build -o /app/myapp

# 运行阶段
FROM frolvlad/alpine-glibc:latest
WORKDIR /app
COPY --from=builder /app/myapp /app/myapp
RUN apk add --no-cache sqlite-libs 
CMD ["/app/myapp"]

总结：根据是否启用 CGO 和依赖库类型，合理选择基础镜像并安装必要依赖，优先通过静态编译简化部署。

package main

import (
    "log"

    "gorm.io/driver/sqlite" // 引入 SQLite 驱动
    "gorm.io/gorm"          // 引入 GORM 库
)

// 定义用户模型
// GORM 会自动根据 struct 名称生成表名（默认是复数形式 "users"）
type User struct {
    ID       uint   `gorm:"primaryKey"` // 主键
    Name     string // 用户名
    Email    string // 邮箱
    Password string // 密码
}

func main() {
    // 初始化数据库连接
    db, err := gorm.Open(sqlite.Open("test.db"), &gorm.Config{})
    if err != nil {
        log.Fatalf("连接数据库失败: %v", err)
    }
    log.Println("数据库连接成功")

    // 自动迁移 - 根据模型创建或更新表结构
    db.AutoMigrate(&User{})
    log.Println("数据库迁移成功")

    // 创建记录
    newUser := User{Name: "张三", Email: "[email protected]", Password: "123456"} // 创建一个新用户实例
    result := db.Create(&newUser)                                                  // 插入到数据库
    if result.Error != nil {
        log.Fatalf("插入记录失败: %v", result.Error)
    }
    log.Printf("记录插入成功，ID: %d", newUser.ID)

    // 查询记录
    var user User
    db.First(&user, "email = ?", "[email protected]") // 根据条件查询用户
    log.Printf("查询到用户: %+v", user)

    // 更新记录
    user.Name = "李四"               // 修改用户名称
    updateResult := db.Save(&user) // 保存更改
    if updateResult.Error != nil {
        log.Fatalf("更新记录失败: %v", updateResult.Error)
    }
    log.Println("记录更新成功")

    // 删除记录
    deleteResult := db.Delete(&user) // 删除该用户
    if deleteResult.Error != nil {
        log.Fatalf("删除记录失败: %v", deleteResult.Error)
    }
    log.Println("记录删除成功")

    select {}

}