C语言如何连接数据库？详细步骤与代码示例分享

在程序开发中，C语言与数据库的连接是实现数据持久化操作的核心环节，无论是小型桌面应用还是大型企业级系统，掌握C语言操作数据库的方法都是开发者必备的技能，本文将详细介绍C语言与数据库连接的主流方式、具体实现步骤及注意事项,帮助开发者快速上手并解决实际开发中的常见问题。

C语言连接数据库的主流方式

C语言本身不直接提供数据库操作功能，需要借助第三方库或接口实现与数据库的交互，目前主流的连接方式包括ODBC、JDBC（需通过JNI调用）、数据库提供的原生API（如MySQL的C API、SQLite的C语言接口）以及ORM框架（如SQLite的ORM封装），ODBC（开放数据库连接）因通用性强、支持多种数据库，成为跨平台开发的首选；而原生API则针对特定数据库优化，性能更高、更轻量,适合对效率要求高的场景。

使用ODBC连接数据库的详细步骤

ODBC是微软提出的数据库访问标准，通过驱动程序管理器（Driver Manager）和数据库驱动实现统一接口，支持MySQL、SQL Server、Oracle等多种数据库,以下是Windows环境下使用ODBC连接MySQL数据库的具体步骤：

环境准备

安装ODBC驱动：从MySQL官网下载“MySQL Connector/ODBC”驱动（如8.0版本），并完成安装，安装后，在“ODBC数据源管理器”（64位系统位于C:WindowsSysWOW64odbcad32.exe）中可看到已安装的MySQL驱动。
配置数据源（可选）：通过“ODBC数据源管理器”创建系统DSN（数据源名称），填写数据库服务器地址、端口、用户名、密码等信息，方便后续直接调用，若不配置DSN,需在代码中手动连接参数。

编写连接代码

使用ODBC连接数据库需包含<sql.h>和<sqlext.h>头文件，核心步骤包括初始化环境、分配句柄、连接数据源、执行SQL语句及释放资源,以下为示例代码：

#include <windows.h>
#include <sql.h>
#include <sqlext.h>
int main() {
    SQLHENV henv;    // 环境句柄
    SQLHDBC hdbc;    // 连接句柄
    SQLHSTMT hstmt;  // 语句句柄
    SQLRETURN ret;   // 返回状态
    // 1. 分配环境句柄
    ret = SQLAllocHandle(SQL_HANDLE_ENV, SQL_NULL_HANDLE, &henv);
    if (!SQL_SUCCEEDED(ret)) {
        printf("分配环境句柄失败n");
        return -1;
    }
    // 2. 设置ODBC版本为3.0
    ret = SQLSetEnvAttr(henv, SQL_ATTR_ODBC_VERSION, (SQLPOINTER)SQL_OV_ODBC3, 0);
    if (!SQL_SUCCEEDED(ret)) {
        printf("设置ODBC版本失败n");
        SQLFreeHandle(SQL_HANDLE_ENV, henv);
        return -1;
    }
    // 3. 分配连接句柄
    ret = SQLAllocHandle(SQL_HANDLE_DBC, henv, &hdbc);
    if (!SQL_SUCCEEDED(ret)) {
        printf("分配连接句柄失败n");
        SQLFreeHandle(SQL_HANDLE_ENV, henv);
        return -1;
    }
    // 4. 连接数据源（未配置DSN时，使用SQLDriverConnect连接）
    SQLCHAR connStr[] = "DRIVER={MySQL ODBC 8.0 Unicode Driver};SERVER=localhost;PORT=3306;UID=root;PWD=password;DATABASE=testdb;";
    ret = SQLDriverConnect(hdbc, NULL, connStr, SQL_NTS, NULL, 0, NULL, SQL_DRIVER_COMPLETE);
    if (!SQL_SUCCEEDED(ret)) {
        SQLCHAR errorMsg[256];
        SQLGetDiagRec(SQL_HANDLE_DBC, hdbc, 1, NULL, NULL, errorMsg, 256, NULL);
        printf("连接数据库失败：%sn", errorMsg);
        SQLFreeHandle(SQL_HANDLE_DBC, henv);
        SQLFreeHandle(SQL_HANDLE_ENV, henv);
        return -1;
    }
    printf("连接数据库成功n");
    // 5. 执行SQL语句（以查询为例）
    ret = SQLAllocHandle(SQL_HANDLE_STMT, hdbc, &hstmt);
    if (!SQL_SUCCEEDED(ret)) {
        printf("分配语句句柄失败n");
        SQLDisconnect(hdbc);
        SQLFreeHandle(SQL_HANDLE_DBC, henv);
        SQLFreeHandle(SQL_HANDLE_ENV, henv);
        return -1;
    }
    ret = SQLExecDirect(hstmt, (SQLCHAR*)"SELECT id, name FROM users", SQL_NTS);
    if (!SQL_SUCCEEDED(ret)) {
        printf("执行SQL失败n");
        SQLFreeHandle(SQL_HANDLE_STMT, hdbc);
        SQLDisconnect(hdbc);
        SQLFreeHandle(SQL_HANDLE_DBC, henv);
        SQLFreeHandle(SQL_HANDLE_ENV, henv);
        return -1;
    }
    // 6. 获取查询结果
    SQLCHAR id[10], name[50];
    SQLLEN idLen, nameLen;
    printf("查询结果：n");
    while (SQL_SUCCEEDED(SQLFetch(hstmt))) {
        SQLGetData(hstmt, 1, SQL_C_CHAR, id, sizeof(id), &idLen);
        SQLGetData(hstmt, 2, SQL_C_CHAR, name, sizeof(name), &nameLen);
        printf("ID: %s, Name: %sn", id, name);
    }
    // 7. 释放资源
    SQLFreeHandle(SQL_HANDLE_STMT, hstmt);
    SQLDisconnect(hdbc);
    SQLFreeHandle(SQL_HANDLE_DBC, henv);
    SQLFreeHandle(SQL_HANDLE_ENV, henv);
    return 0;
}

编译与运行

在Windows下使用Visual Studio编译时，需包含odbc32.lib库，并在项目属性中添加库路径；使用MinGW编译时，可通过-lodbc链接，Linux环境下需安装unixODBC开发包,编译方式类似。

使用原生API连接数据库（以MySQL为例）

原生API是数据库官方提供的C语言接口，无需ODBC驱动管理器，直接与数据库通信，性能更优，以下是使用MySQL C API连接数据库的步骤：

环境准备

从MySQL官网下载“MySQL C Connector”（如mysql-client-c库），并配置开发环境，Windows下需将libmysql.lib添加到项目，Linux下需安装libmysqlclient-dev包。

核心代码示例

#include <mysql/mysql.h>
#include <stdio.h>
int main() {
    MYSQL *conn;
    MYSQL_RES *res;
    MYSQL_ROW row;
    // 初始化连接句柄
    conn = mysql_init(NULL);
    if (conn == NULL) {
        printf("mysql_init失败：%sn", mysql_error(conn));
        return -1;
    }
    // 连接数据库（参数：主机、用户、密码、数据库、端口、socket、标志）
    if (mysql_real_connect(conn, "localhost", "root", "password", "testdb", 3306, NULL, 0) == NULL) {
        printf("连接数据库失败：%sn", mysql_error(conn));
        mysql_close(conn);
        return -1;
    }
    printf("连接数据库成功n");
    // 执行SQL语句
    if (mysql_query(conn, "SELECT id, name FROM users")) {
        printf("执行SQL失败：%sn", mysql_error(conn));
        mysql_close(conn);
        return -1;
    }
    // 获取结果集
    res = mysql_store_result(conn);
    if (res == NULL) {
        printf("获取结果集失败：%sn", mysql_error(conn));
        mysql_close(conn);
        return -1;
    }
    // 遍历结果集
    printf("查询结果：n");
    while ((row = mysql_fetch_row(res)) != NULL) {
        printf("ID: %s, Name: %sn", row[0], row[1]);
    }
    // 释放结果集和连接
    mysql_free_result(res);
    mysql_close(conn);
    return 0;
}

注意事项

原生API与数据库版本强相关，不同版本API可能存在差异,需参考官方文档。
执行多语句（如INSERT INTO ...; UPDATE ...）需使用mysql_real_query并设置CLIENT_MULTI_STATEMENTS标志。

连接数据库的常见问题与解决方案

连接超时或失败
检查数据库服务是否启动、网络是否可达、用户名密码是否正确，以及防火墙是否阻止端口访问（如MySQL默认3306端口），若使用远程连接，需确保数据库服务器允许远程IP访问（MySQL中需GRANT权限并设置bind-address）。
字符集乱码
在连接字符串或API调用中明确指定字符集，如ODBC连接时添加charset=utf8，MySQL C API中使用mysql_set_character_set(conn, "utf8mb4")，确保数据库、表、字段均使用UTF-8编码。

C语言如何连接数据库？详细步骤与代码示例分享

C语言连接数据库的主流方式

使用ODBC连接数据库的详细步骤