OCCI连接Oracle数据库失败，报ORA-01017无效用户名/密码错误

核心解决方案 #

针对你遇到的OCCI认证失败问题，以下是优先级最高的排查步骤：

1. 显式指定OCCI环境的字符集 #

SQL*Plus和ODBC会自动适配字符集，但OCCI默认可能未同步客户端与数据库的编码设置，导致用户名/密码传递时出现编码异常。修改环境创建代码：

Environment* env = Environment::createEnvironment(
    Environment::DEFAULT,
    NULL,
    NULL,
    (oratext*)"AL32UTF8", // 客户端字符集
    (oratext*)"AL32UTF8"  // 数据库字符集
);

2. 确保OCCI库版本与数据库完全匹配 #

如果系统中存在多个Oracle客户端（比如同时安装了数据库本体和Instant Client），OCCI可能加载了不兼容的库文件。在VS链接器中直接指定数据库安装目录下的OCCI库路径，例如：
ORACLE_HOME\oci\lib\msvc\oci.lib

3. 切换为TNS别名连接 #

尝试用tnsnames.ora中的别名替代EZConnect字符串，避免解析差异：

string connStr = "ORCL"; // 对应tnsnames.ora中的ORCL条目

4. 启用OCI追踪日志定位细节 #

设置以下环境变量后运行程序，日志会记录连接全流程的交互细节，包括用户名密码的传递状态：

• OCI_TRACE_LEVEL=10
• OCI_TRACE_FILE=oci_trace.log

针对你的问题逐一解答 #

问题1：为何其他工具可正常连接，唯独OCCI出现ORA-01017？ #

核心差异在于字符集处理逻辑和库版本兼容性：

• SQL*Plus和ODBC会自动检测并适配客户端与数据库的字符集，而OCCI默认依赖显式配置，未指定时可能出现编码转换错误，导致认证凭证被篡改。
• 若系统中存在多版本Oracle客户端，OCCI可能优先加载与数据库版本不匹配的库，引发认证协议不兼容。

问题2：OCCI中是否有类似SQLDriverConnect的工具用于排查连接过程？ #

有两种实用方式：

1. OCI追踪日志：通过设置上述环境变量，生成包含连接交互细节的日志，可直接查看认证步骤中用户名密码的传递状态。
2. OCCI异常扩展信息：除e.what()外，可通过e.getErrorCode()获取精确错误码、e.getMessage()获取数据库返回的详细错误描述，定位认证失败的具体环节。

问题3：使用OCCI时，UTF-8或Oracle钱包是否需要特定设置或标志？ #

• UTF-8字符集：必须在创建Environment时显式指定字符集参数，否则即使系统字符集为AL32UTF8，OCCI仍可能使用默认编码传递凭证。
• Oracle钱包免密登录：需设置环境变量ORA_WALLET_LOCATION指向钱包目录（格式为(SOURCE=(METHOD=FILE)(METHOD_DATA=(DIRECTORY=C:\path\to\wallet)))），并在创建连接时传入空用户名和密码：

  Connection* conn = env->createConnection("", "", "ORCL");
  

修改后的完整测试代码 #

#include <occi.h>
#include <iostream>

using namespace oracle::occi;

int main() {
    string user = "TESTING";
    string pass = "TESTING";
    string connStr = "ORCL";

    try {
        Environment* env = Environment::createEnvironment(
            Environment::DEFAULT,
            NULL,
            NULL,
            (oratext*)"AL32UTF8",
            (oratext*)"AL32UTF8"
        );
        Connection* conn = env->createConnection(user, pass, connStr);
        std::cout << "Connected to Oracle Database!" << std::endl;
        std::cout << "Logged in as: " << conn->getUserName() << std::endl;
        
        env->terminateConnection(conn);
        Environment::terminateEnvironment(env);
    } catch (SQLException& e) {
        std::cerr << "Error Code: " << e.getErrorCode() << std::endl;
        std::cerr << "Error Message: " << e.getMessage() << std::endl;
        std::cerr << "Error Details: " << e.what() << std::endl;
    }

    return 0;
}

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