如何为Go应用部署SQLite数据库并解决相对路径连接问题

问题原因 #

你遇到的"out of memory (14)"错误并非真的内存不足，而是SQLite无法找到或创建指定路径的数据库文件。代码中使用的相对路径data/database/data.db是基于程序运行的工作目录，而非db.go文件所在的目录。如果运行程序时的工作目录不是app根目录，这个路径就会指向不存在的位置，触发错误。

解决方法 #

方法1：基于可执行文件路径构造绝对路径（推荐） #

通过获取当前可执行文件的位置，动态拼接数据库文件的绝对路径，不受工作目录影响：

import (
    "path/filepath"
    "os"
    "gorm.io/driver/sqlite"
    "gorm.io/gorm"
    "gorm.io/gorm/schema"
)

func (d *Database) Connect() {
    // 获取当前可执行文件的完整路径
    exePath, err := os.Executable()
    if err != nil {
        panic("无法获取可执行文件路径: " + err.Error())
    }
    // 得到可执行文件所在目录（对应app/api）
    exeDir := filepath.Dir(exePath)
    // 构造数据库文件的相对路径，再转换为绝对路径
    dbPath := filepath.Join(exeDir, "../data/database/data.db")
    dbPath, err = filepath.Abs(dbPath)
    if err != nil {
        panic("无法转换为绝对路径: " + err.Error())
    }

    d.Database, err = gorm.Open(sqlite.Open(dbPath), &gorm.Config{
        NamingStrategy: schema.NamingStrategy{
            SingularTable: true,
            NoLowerCase:   true,
        },
    })
    if err != nil {
        panic("数据库连接失败: " + err.Error())
    }
}

方法2：固定程序运行的工作目录 #

在app根目录下执行程序，确保相对路径指向正确位置：

# 进入app目录
cd /path/to/app
# 运行源码程序
go run api/main.go
# 编译后运行
go build -o api/api-bin api/main.go
./api/api-bin

服务器部署注意事项 #

• 路径一致性：优先使用基于可执行文件的绝对路径方案，避免因工作目录变化导致数据库路径失效。如果用工作目录方案，要在启动脚本中明确切换到app根目录再运行程序。
• 文件权限：确保运行程序的系统用户对app/data/database目录和data.db文件有读写权限，否则SQLite无法写入数据或打开文件。Linux/macOS下可通过chmod、chown命令设置权限。
• 数据库备份：定期备份data.db文件，SQLite是文件型数据库，可直接复制文件完成备份（建议在低峰期备份，或使用SQLite内置的备份API避免数据不一致）。
• 跨平台路径适配：服务器如果是Linux/macOS系统，路径分隔符为/，Windows为\，全部使用filepath.Join拼接路径，自动适配不同系统。
• 错误处理优化：部署环境中不要使用panic，改用日志库（如log、zap）记录错误信息，方便排查问题，同时避免程序直接崩溃。
• 目录结构保持：部署时不要随意修改app下的目录层级，确保可执行文件与data目录的相对位置不变，保证路径逻辑有效。

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