在C#开发中对接Oracle数据库时，ODP.NET是官方推荐的驱动方案，它性能稳定且功能全面，不过很多开发者在配置过程中会遇到各种问题，尤其是中文乱码的情况比较常见。下面我们就一步步讲解完整的实现和解决问题的方法。
环境准备与依赖引入
首先需要在项目中引入ODP.NET相关依赖，目前常用的有两种方式，一种是安装Oracle官方的NuGet包，另一种是手动引用安装Oracle客户端后的DLL文件。
NuGet方式引入
在Visual Studio的NuGet包管理器中搜索Oracle.ManagedDataAccess，选择对应版本安装即可，这个托管版本的驱动不需要额外安装Oracle客户端，部署更方便。
手动引用方式
如果选择非托管版本，需要先安装Oracle客户端，然后在项目引用中添加Oracle.DataAccess.dll，注意DLL的位数需要和项目编译的位数一致，否则会出现加载失败的问题。
ODP.NET连接配置
连接Oracle数据库需要正确配置连接字符串，常见的连接字符串格式如下：
// 基本连接字符串示例 string connectionString = "User Id=用户名;Password=密码;Data Source=(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=数据库IP)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=服务名)))";
如果需要使用TNS别名方式连接，需要确保本地的tnsnames.ora文件配置正确，连接字符串可以简化为：
string connectionString = "User Id=用户名;Password=密码;Data Source=TNS别名";
基础连接代码示例
下面是使用ODP.NET查询数据的完整示例代码：
using Oracle.ManagedDataAccess.Client;
using System;
using System.Data;
public class OracleHelper
{
public static DataTable QueryData(string connectionString, string sql)
{
DataTable dt = new DataTable();
// 创建Oracle连接
using (OracleConnection conn = new OracleConnection(connectionString))
{
try
{
conn.Open();
// 创建命令对象
OracleCommand cmd = new OracleCommand(sql, conn);
OracleDataAdapter adapter = new OracleDataAdapter(cmd);
// 填充数据到DataTable
adapter.Fill(dt);
}
catch (Exception ex)
{
Console.WriteLine("查询失败：" + ex.Message);
}
finally
{
if (conn.State == ConnectionState.Open)
{
conn.Close();
}
}
}
return dt;
}
}
中文乱码问题解决方案
中文乱码通常是由于客户端和服务器端的字符集不匹配导致的，下面是几种常见的解决方式。
检查服务器端字符集
首先可以查询Oracle服务器端的字符集，执行以下SQL语句：
select userenv('language') from dual;
如果返回的结果是类似SIMPLIFIED CHINESE_CHINA.ZHS16GBK或者AL32UTF8的内容，记录下这个字符集信息。
配置客户端字符集
在C#项目中，可以通过设置环境变量来指定客户端字符集，确保和服务器端一致，代码示例如下：
// 在程序启动时设置环境变量，字符集需要和服务器端查询结果一致
Environment.SetEnvironmentVariable("NLS_LANG", "SIMPLIFIED CHINESE_CHINA.ZHS16GBK");
如果是使用非托管版本的ODP.NET，也可以在系统的环境变量中添加NLS_LANG变量，值设置为和服务器端匹配的字符集。
连接字符串中添加字符集参数
部分场景下可以在连接字符串中直接指定字符集，格式如下：
// 添加Unicode参数的连接字符串 string connectionString = "User Id=用户名;Password=密码;Data Source=(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=数据库IP)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=服务名)));Unicode=True";
参数化传值避免乱码
在执行插入或更新操作时，尽量使用参数化传值，避免拼接SQL字符串，这样可以减少字符编码转换带来的乱码问题，示例：
using (OracleConnection conn = new OracleConnection(connectionString))
{
conn.Open();
string sql = "insert into test_table (id, name) values (:id, :name)";
OracleCommand cmd = new OracleCommand(sql, conn);
// 添加参数，指定参数类型
cmd.Parameters.Add(new OracleParameter("id", OracleDbType.Int32)).Value = 1;
cmd.Parameters.Add(new OracleParameter("name", OracleDbType.Varchar2)).Value = "测试中文内容";
cmd.ExecuteNonQuery();
}
常见问题排查
- 如果连接时出现
ORA-12154错误，通常是TNS配置或者连接字符串中的服务名有误，需要检查Data Source配置是否正确。 - 如果中文显示乱码但是英文正常，优先检查NLS_LANG配置是否和服务器端字符集匹配。
- 使用托管版本ODP.NET时，不需要安装Oracle客户端，但是需要注意.NET Framework版本和驱动版本的兼容性。