如何创建可访问SQLite数据库的C++ 32位DLL？

问题概述 #

• 目标：为遗留32位应用开发可访问SQLite的32位C++ DLL，满足单文件夹部署、不修改外部环境的要求
• 环境：Dev-C++ IDE + MinGW-w64 TDM-GCC 32位编译环境
• 已完成工作：无数据库访问逻辑的32位DLL已实现并可被32位应用正常调用；弃用SQLite ODBC驱动（需安装，不符合部署要求）
• 核心问题：
  • 64位编译的SQLite相关DLL无法被32位应用加载
  • 32位编译时出现undefined reference to 'sqlite3_open'等链接错误；手动编译sqlite3.c为32位目标文件时报错

解决方案 #

1. 编译32位SQLite静态库 #

下载SQLite官方的amalgamation包（包含完整的sqlite3.c和sqlite3.h），使用32位MinGW工具链编译静态库：

# 编译生成32位目标文件
gcc -m32 -c sqlite3.c -o sqlite3.o
# 将目标文件打包为静态库
ar rcs libsqlite3.a sqlite3.o

若编译出错，检查MinGW-w64 TDM-GCC 32位工具链是否完整安装，环境变量是否正确配置（确保gcc、ar等命令可在终端正常执行）。

2. 修正DLL代码中的关键问题 #

（1）避免C++名字 mangling

在testsql.cpp中用extern "C"包裹SQLite头文件引用，防止C++编译器修改SQLite函数名导致链接错误：

#include <iostream>
#include <string>
#include <cstring> // 新增，用于strcpy操作
#include "testsql.h"

// 用extern "C"包裹SQLite头文件，保证函数名不被修改
extern "C" {
#include "sqlite3.h" // 建议将sqlite3.h放到项目include目录，不要用绝对路径
}

（2）修正函数参数不匹配问题

头文件中sql_connect声明的参数为char* s，但原cpp文件中定义为std::string s，导致链接失败，统一参数类型并修复硬编码路径：

int sql_connect(char* s)
{   
    sqlite3* DB;    
    int exit = 0; 
    exit = sqlite3_open(s, &DB); // 使用传入的路径参数，替换硬编码路径
  
    if (exit) { 
        std::cerr << "Error open DB " << sqlite3_errmsg(DB) << std::endl; 
        sqlite3_close(DB); // 出错时必须关闭数据库句柄，避免资源泄漏
        return (-1); 
    } 
    else { // 补充花括号，确保代码块归属正确
        std::cout << "Opened Database Successfully!" << std::endl; 
        sqlite3_close(DB); 
        return (0); 
    }
}

（3）修复局部字符串返回的野指针问题

原sql_char函数返回局部std::string的指针，函数结束后内存会被释放，导致野指针，改为分配堆内存：

char* sql_char(char* a)
{
    std::string s = "Hello ";
    std::string c = a;
    s += c;
    
    // 分配堆内存存储结果，调用者需负责用delete[]释放
    char* r = new char[s.size() + 1];
    strcpy(r, s.c_str());
    return r;
}

3. 配置Dev-C++项目编译32位DLL #

1. 打开项目，进入项目选项
2. 编译器标签：勾选-m32选项，强制32位编译
3. 链接器标签：
   • 添加静态库路径：指向刚才编译的libsqlite3.a所在目录
   • 添加链接库：输入sqlite3（即链接libsqlite3.a）
4. 确认项目输出类型设置为DLL

4. 部署验证 #

编译生成的32位DLL已静态链接SQLite，无需额外依赖文件，直接将DLL放到遗留32位应用的同目录即可运行，满足单文件夹部署要求。

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