Golang项目使用github.com/mattn/go-sqlite3库时运行报错如何解决

Golang项目使用github.com/mattn/go-sqlite3库时运行报错如何解决 每当我使用 go run main.go 运行代码时，一旦代码调用在 sqlite 数据库中创建表的函数，命令行就会显示以下错误。

2023/06/02 22:45:23 Binary was compiled with ‘CGO_ENABLED=0’, go-sqlite3 requires cgo to work. This is a stub

我应该怎么做才能手动启用 cgo？我原以为 cgo 是自动启用的。

2 回复

你好 @Nucl3arSn3k，

如果你使用 Bash，可以尝试 CGO_ENABLED=1 go run main.go。（对于其他 shell，语法可能有所不同。）

cgo 命令文档中提到：

在预期可以工作的系统上进行本地构建时，cgo 工具默认是启用的。在交叉编译时，或者当 CC 环境变量未设置且系统 PATH 中找不到默认的 C 编译器（通常是 gcc 或 clang）时，它默认是禁用的。你可以在运行 go 工具时通过设置 CGO_ENABLED 环境变量来覆盖默认值：将其设置为 1 以启用 cgo，设置为 0 以禁用它。

你可以通过以下命令检查其值：

go env CGO_ENABLED

并针对你本地的 Go 工具链，使用以下命令进行更新：

go env -w CGO_ENABLED=<0 或 1>

更多关于Golang项目使用github.com/mattn/go-sqlite3库时运行报错如何解决的实战系列教程也可以访问 https://www.itying.com/category-94-b0.html


这个错误表明你的程序在编译时禁用了CGO，但go-sqlite3库需要CGO才能工作。以下是解决方法：

1. 设置CGO_ENABLED环境变量

在运行或构建时启用CGO：

# 临时设置环境变量
CGO_ENABLED=1 go run main.go

# 或者先设置环境变量再运行
export CGO_ENABLED=1
go run main.go

2. 在构建时指定CGO_ENABLED

如果你需要构建可执行文件：

CGO_ENABLED=1 go build -o myapp main.go
./myapp

3. 使用构建标签

在代码文件顶部添加构建约束：

//go:build cgo
// +build cgo

package main

import (
    _ "github.com/mattn/go-sqlite3"
    "database/sql"
)

func main() {
    db, err := sql.Open("sqlite3", "./test.db")
    if err != nil {
        panic(err)
    }
    defer db.Close()
    
    // 创建表示例
    _, err = db.Exec(`CREATE TABLE IF NOT EXISTS users (
        id INTEGER PRIMARY KEY,
        name TEXT NOT NULL
    )`)
    if err != nil {
        panic(err)
    }
}

4. 检查系统依赖

确保系统已安装SQLite开发库：

# Ubuntu/Debian
sudo apt-get install libsqlite3-dev

# macOS
brew install sqlite3

# CentOS/RHEL
sudo yum install sqlite-devel

5. 完整的示例代码

package main

import (
    "database/sql"
    "log"
    _ "github.com/mattn/go-sqlite3"
)

func main() {
    db, err := sql.Open("sqlite3", "./test.db")
    if err != nil {
        log.Fatal(err)
    }
    defer db.Close()

    // 创建表
    createTableSQL := `CREATE TABLE IF NOT EXISTS users (
        id INTEGER PRIMARY KEY AUTOINCREMENT,
        name TEXT NOT NULL,
        email TEXT NOT NULL UNIQUE,
        created_at DATETIME DEFAULT CURRENT_TIMESTAMP
    );`
    
    _, err = db.Exec(createTableSQL)
    if err != nil {
        log.Fatal(err)
    }
    
    log.Println("Table created successfully")
}

6. 使用Makefile管理构建

创建Makefile文件：

.PHONY: run build

run:
    CGO_ENABLED=1 go run main.go

build:
    CGO_ENABLED=1 go build -o app main.go

clean:
    rm -f app test.db

然后运行：

make run

7. 验证CGO是否启用

创建测试文件验证CGO状态：

package main

/*
#include <stdio.h>
void hello() {
    printf("CGO is enabled\n");
}
*/
import "C"

func main() {
    C.hello()
}

运行测试：

CGO_ENABLED=1 go run cgo_test.go

如果系统默认禁用了CGO（比如在某些Docker镜像或CI/CD环境中），需要显式启用。在Go模块项目中，这些设置不会影响跨平台编译，但使用go-sqlite3时需要确保目标平台支持CGO。

回到顶部