C++调用ODBC连接SQL Server参数类型不兼容问题排查

问题根源 #

这个错误是因为新项目的字符集配置和原项目不一致：

• 原项目大概率用的是「多字节字符集（ANSI）」，ODBC默认调用ANSI版本的函数（如SQLGetDiagRecA），和SQLCHAR类型匹配。
• 新项目默认可能是「Unicode字符集（UTF-16）」，ODBC自动调用宽字符版本的函数（如SQLGetDiagRecW），但代码里传的是SQLCHAR（窄字符），类型不兼容导致报错。

两种解决办法 #

办法1：继续使用SQLCHAR（保持ANSI版本） #

方案A：显式调用ANSI版本函数

直接指定调用SQLGetDiagRecA，强制使用ANSI版本，不受项目字符集影响：

SQLCHAR SQLState[1024];
SQLCHAR message[1024];
// 显式调用ANSI版本的SQLGetDiagRecA
if (SQL_SUCCESS == SQLGetDiagRecA(handleType, handle, 1, SQLState, NULL, message, 1024, NULL))
{
    cout << "SQL driver message: " << message << "\nSQL state: " << SQLState << "." << endl;
}

方案B：修改新项目字符集为多字节

在Visual Studio中：

• 右键项目 → 属性 → 配置属性 → 常规 → 字符集
• 选择「使用多字节字符集」，点击确定后重新编译。

办法2：改用SQLWCHAR（宽字符版本，解决连接失败问题） #

如果要切换到宽字符，需要同步调整所有相关的ODBC函数调用和字符串处理：

1. 把SQLCHAR改为SQLWCHAR，调用宽字符版本的ODBC函数（编译器会自动匹配SQLGetDiagRecW）；
2. 输出时用wcout而非cout，因为SQLWCHAR是宽字符类型；
3. 连接字符串也要改为宽字符格式（用L""前缀），并确保连接函数（如SQLDriverConnect）也使用宽字符版本。

示例代码：

SQLWCHAR SQLState[1024];
SQLWCHAR message[1024];
if (SQL_SUCCESS == SQLGetDiagRec(handleType, handle, 1, SQLState, NULL, message, 1024, NULL))
{
    // 用wcout输出宽字符
    wcout << L"SQL driver message: " << message << L"\nSQL state: " << SQLState << L"." << endl;
}

// 连接字符串示例（宽字符）
SQLWCHAR connStr[] = L"DRIVER={SQL Server};SERVER=your_server;DATABASE=your_db;UID=your_user;PWD=your_pwd;";
SQLDriverConnect(handle, NULL, connStr, SQL_NTS, NULL, 0, NULL, SQL_DRIVER_COMPLETE);

你之前改SQLCHAR为SQLWCHAR后连接失败，大概率是连接部分的字符串或函数调用没同步改成宽字符，导致参数不匹配，按上面的方式统一调整即可。

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