C# 應用通過 ODP.NET 連接 Oracle 實戰部署指南：免安裝客戶端輕量化方案

架構優勢：Instant Client + ODP.NET

傳統 Oracle 客戶端安裝包超 1GB，部署繁瑣。採用 Oracle Instant Client（約 70MB）配合 ODP.NET Managed Driver 可實現零安裝、xcopy 部署，適配容器化、Serverless 等現代架構。

組件獲取與版本對應

下載地址：Oracle ODAC 官方下載頁

三步輕量化部署流程

1. 解壓核心文件

從 ODAC 包提取以下文件至應用目錄 bin\Oracle：

• oci.dll、oraociei19.dll（Instant Client 核心）
• Oracle.ManagedDataAccess.dll（Managed Driver，推薦）
• 或 Oracle.DataAccess.dll（Unmanaged Driver，需匹配位數）

2. 環境變量配置（僅 Unmanaged Driver 需要）

SET ORACLE_HOME=C:\App\bin\Oracle
SET PATH=%ORACLE_HOME%;%PATH%
SET TNS_ADMIN=%ORACLE_HOME%\network\admin

Managed Driver 完全無需環境變量，配置全在 app.config 中完成。

3. TNS 配置文件

在 TNS_ADMIN 目錄創建 tnsnames.ora：

ORCL_PROD =
  (DESCRIPTION =
    (ADDRESS_LIST =
      (ADDRESS = (PROTOCOL = TCP)(HOST = 192.168.1.100)(PORT = 1521))
    )
    (CONNECT_DATA =
      (SERVICE_NAME = ORCL)
      (SERVER = DEDICATED)
    )
  )

C# 連接代碼最佳實踐

托管驅動標準模式（推薦）

using Oracle.ManagedDataAccess.Client;
using System.Configuration;

public class OracleRepository : IDisposable
{
    private readonly OracleConnection _conn;
    
    public OracleRepository(string connectionName = "OracleConn")
    {
        var connStr = ConfigurationManager.ConnectionStrings[connectionName].ConnectionString;
        _conn = new OracleConnection(connStr);
        _conn.Open();
    }
    
    public IEnumerable<T> Query<T>(string sql, object param = null)
    {
        using var cmd = _conn.CreateCommand();
        cmd.CommandText = sql;
        cmd.BindByName = true; // 關鍵：按名稱綁定參數
        
        if (param != null)
        {
            foreach (var prop in param.GetType().GetProperties())
            {
                cmd.Parameters.Add(prop.Name, prop.GetValue(param));
            }
        }
        
        using var reader = cmd.ExecuteReader();
        while (reader.Read())
        {
            yield return MapToEntity<T>(reader);
        }
    }
    
    public void Dispose() => _conn?.Dispose();
}

配置文件範本

<configuration>
  <configSections>
    <section name="oracle.manageddataaccess.client" 
             type="OracleInternal.Common.ODPMSectionHandler, Oracle.ManagedDataAccess" />
  </configSections>
  
  <connectionStrings>
    <add name="OracleConn" 
         connectionString="Data Source=ORCL_PROD;User Id=app_user;Password=***;Pooling=true;Min Pool Size=5;Max Pool Size=100;"
         providerName="Oracle.ManagedDataAccess.Client" />
  </connectionStrings>
  
  <oracle.manageddataaccess.client>
    <version number="*"/>
    <settings>
      <setting name="TNS_ADMIN" value=".\Oracle\network\admin" />
      <setting name="SQLNET.ENCRYPTION_CLIENT" value="REQUIRED" />
      <setting name="SQLNET.ENCRYPTION_TYPES_CLIENT" value="AES256" />
    </settings>
  </oracle.manageddataaccess.client>
</configuration>

連接池優化參數

常見問題排查

遷移建議：Unmanaged → Managed

1. NuGet 安裝 Oracle.ManagedDataAccess.Core（.NET Core/5+）或 Oracle.ManagedDataAccess（.NET Framework）
2. 移除 Oracle.DataAccess.dll 所有引用
3. 命名空間統一為 Oracle.ManagedDataAccess.Client
4. 刪除環境變量依賴，配置下沉至 app.config
5. 測試驗證：連接池、事務、REF CURSOR、Udt 等場景