萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> ASP.NET 程式設計

ASP.NET MVC 4 on Mono (CentOS 6.x) 使用 OracleClient 完整部署實戰記錄

將 ASP.NET MVC 4 應用程式部署至 CentOS 6.x (Mono + Jexus) 並連接 Oracle 資料庫,是一項極具挑戰性的任務。本文記錄從 Oracle Instant Client 安裝、環境變數設定、到 System.Data.OracleClient 在 Mono 下運作的完整排坑過程。

環境需求

  • 作業系統:CentOS 6.5 (Final), Kernel 2.6.32-431.5.1.el6.i686
  • Mono 版本:3.0.12 (JIT compiler)
  • Web Server:Jexus 5.5.1
  • 資料庫:Oracle 12c (需相容 12.1 Instant Client)

步驟 1:安裝 Oracle Instant Client (12.1 版)

從 Oracle 官網下載以下四個 RPM 套件(i386 版以相容 32 位元 Mono):

  • oracle-instantclient12.1-basic-12.1.0.1.0-1.i386.rpm
  • oracle-instantclient12.1-sqlplus-12.1.0.1.0-1.i386.rpm
  • oracle-instantclient12.1-devel-12.1.0.1.0-1.i386.rpm
  • oracle-instantclient12.1-odbc-12.1.0.1.0-1.i386.rpm

安裝指令:

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/。

步驟 2:設定環境變數 (/etc/profile)

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

步驟 3:配置 TNS 連線資訊

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))
#   )

步驟 4:註冊共用程式庫路徑

echo "/usr/lib/oracle/12.1/client/lib" > /etc/ld.so.conf.d/oracle-i386.conf
ldconfig

步驟 5:驗證安裝

sqlplus user/pass@ORCL
# 若成功進入 SQL*Plus 介面,表示 Client 端設定正確

核心問題:System.DllNotFoundException: libclntsh.so

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
  • MonoDevelop 偵錯模式下竟能正常運作(非偵錯則失效),極度詭異
  • 懷疑 Jexus 5.4.0 載入程式庫路徑機制有問題

最終解決:升級 Jexus 至 5.5.1

在嘗試改用 mod_mono + Apache 之前,抱著死馬當活馬醫心態升級 Jexus 至最新版 5.5.1,所有異常瞬間消失,系統完美運行。

經驗總結

  1. Jexus 版本至關重要: 5.4.0 存在載入非受控程式庫的缺陷,5.5.1 已修復。
  2. 32/64 位元一致性: Mono、Oracle Client、Jexus 必須位元數一致(本案皆為 32 位元)。
  3. NLS_LANG 設定: 必須與資料庫字元集完全一致,否則中文會亂碼。
  4. 替代方案: 若持續遇到問題,建議改用 Oracle.ManagedDataAccess (全受控實作,無相依非受控 DLL) 或 Devart dotConnect for Oracle (商業付費但穩定)。

此部署案例證明:在 Linux 上運行 .NET 應用連接 Oracle,Web Server (Jexus) 的版本選擇往往是關鍵變數。

copyright © 萬盛學電腦網 all rights reserved