將 ASP.NET MVC 4 應用程式部署至 CentOS 6.x (Mono + Jexus) 並連接 Oracle 資料庫,是一項極具挑戰性的任務。本文記錄從 Oracle Instant Client 安裝、環境變數設定、到 System.Data.OracleClient 在 Mono 下運作的完整排坑過程。
從 Oracle 官網下載以下四個 RPM 套件(i386 版以相容 32 位元 Mono):
安裝指令:
rpm -ivh oracle-instantclient12.1-basic-12.1.0.1.0-1.i386.rpm
rpm -ivh oracle-instantclient12.1-sqlplus-12.1.0.1.0-1.i386.rpm
rpm -ivh oracle-instantclient12.1-devel-12.1.0.1.0-1.i386.rpm
rpm -ivh oracle-instantclient12.1-odbc-12.1.0.1.0-1.i386.rpm
安裝完成後,程式庫位於 /usr/lib/oracle/12.1/client/lib/。
export ORACLE_BASE=/usr/lib/oracle/12.1
export ORACLE_HOME=$ORACLE_BASE/client
export ORACLE_SID=orcl # 依實際 SID 調整
export LD_LIBRARY_PATH=$ORACLE_HOME/lib:$LD_LIBRARY_PATH
export NLS_LANG=AMERICAN_AMERICA.AL32UTF8 # 必須與資料庫字元集一致
# 立即生效
source /etc/profile
mkdir -p /usr/lib/oracle/12.1/client/network/admin
# 將 tnsnames.ora 放入上述目錄
# 範例內容:
# ORCL =
# (DESCRIPTION =
# (ADDRESS = (PROTOCOL = TCP)(HOST = 192.168.1.100)(PORT = 1521))
# (CONNECT_DATA = (SERVER = DEDICATED)(SERVICE_NAME = ORCL))
# )
echo "/usr/lib/oracle/12.1/client/lib" > /etc/ld.so.conf.d/oracle-i386.conf
ldconfig
sqlplus user/pass@ORCL
# 若成功進入 SQL*Plus 介面,表示 Client 端設定正確
Mono 運行時無法載入 Oracle 非受控程式庫 libclntsh.so,導致 System.Data.OracleClient 初始化失敗。錯誤堆疊:
System.DllNotFoundException: libclntsh.so
at (wrapper managed-to-native) System.Data.OracleClient.Oci.OciCalls/OciNativeCalls:OCIEnvCreate ...
at System.Data.OracleClient.OracleConnection.Open ()
LD_LIBRARY_PATH 包含 Oracle lib 目錄ldconfig 重新載入共用程式庫快取ln -s libclntsh.so.12.1 libclntsh.so在嘗試改用 mod_mono + Apache 之前,抱著死馬當活馬醫心態升級 Jexus 至最新版 5.5.1,所有異常瞬間消失,系統完美運行。
此部署案例證明:在 Linux 上運行 .NET 應用連接 Oracle,Web Server (Jexus) 的版本選擇往往是關鍵變數。