安裝或使用cx_Oracle時，需要用到Oracel的連結庫，如libclntsh.so.10.1，否則會有各種各樣的錯誤資訊。

     安裝Oracle Instant Client就可得到這個連結庫，避免安裝幾百兆之巨的Oracle Client。

軟體下載地址：

常見的錯誤和解決方法：

一.win32二進位制安裝

在windows下安裝cx_Oracle-5.0-10g.win32-py2.6.msi之後，匯入時，報DLL載入失敗的錯誤，如下：

IDLE 2.6.1     
>>> import cx_Oracle

Traceback (most recent call last):
  File "<pyshell#0>", line 1, in <module>
    import cx_Oracle
ImportError: DLL load failed: 找不到指定的程式。

解決方法：

    從Oracle站點下載instantclient-basic-win32-10.2.0.4.zip，解壓後，將其中的oci.dll檔案複製到python安裝目錄的Lib/site-packages下，如 C:/Python26/Lib/site-packages

二.linux下二進位制安裝

在linux_x86_64下，安裝cx_Oracle-5.0.1-10g-py24-1.x86_64.rpm時報錯。

[[email protected] ~]# rpm -ivh cx_Oracle-5.0.1-10g-py24-1.x86_64.rpm
error: Failed dependencies:
        libclntsh.so.10.1()(64bit) is needed by cx_Oracle-5.0.1-1.x86_64

解決方法：

從Oracle站點下載basic-10.2.0.4.0-linux-x86_64.zip到/opt目錄並解壓，會看到libclntsh.so.10.1在/opt/instantclient_10_2目錄中

設定環境變數

vi /root/.bash_profile

增加如下兩行：

export ORACLE_HOME=/opt/instantclient_10_2
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$ORACLE_HOME
執行source /root/.bash_profile使改動生效

建立此連結庫的符號連結

cd $ORACLE_HOME

ln -s libclntsh.so.x.x libclntsh.so

重新安裝cx_Oracle

注意加--nodeps引數，否則還會報上述錯誤

[[email protected] ~]# rpm -ivh --nodeps cx_Oracle-5.0.1-10g-py24-1.x86_64.rpm 

#5.0.3版本不用加--nodeps引數

三.linux下原始碼安裝

設定環境變數及符號連結如上，在linux_x86_64下原始碼安裝，執行python setup.py build,編譯時錯誤資訊如下： 

Connection.c:1169: 警告：語句不起作用
Connection.c:1171: 錯誤：‘udt_Connection’ 沒有名為 ‘environment’ 的成員
Connection.c:1172: 警告：傳遞引數 1 (屬於 ‘Environment_CheckForError’)時在不相容的指標型別間轉換
Connection.c:1172: 警告：傳遞引數 2 (屬於 ‘Environment_CheckForError’)時在不相容的指標型別間轉換
Connection.c:1172: 錯誤：提供給函式 ‘Environment_CheckForError’ 的實參太多
Connection.c:1176: 錯誤：‘udt_Connection’ 沒有名為 ‘sessionHandle’ 的成員

解決方法：

5.0.3版本的未出現此錯誤，要注意ORACLE_HOME下要有include目錄，這個目錄中要有編譯需要的原始檔，原始檔在Oracle Instant Client這個客戶端中沒有包含。我是從windows客戶端的D:/oracle/product/10.2.0/client_1/oci/include這個目錄中拷貝的。

四.import錯誤

>>> import cx_Oracle
Traceback (most recent call last):
  File "<stdin>", line 1, in ?
ImportError: /usr/lib/oracle/10.2.0.4/client64//lib/libnnz10.so: cannot restore segment prot after reloc: Permission denied
>>> import cx_Oracle
Traceback (most recent call last):
  File "<stdin>", line 1, in ?
ImportError: /usr/lib/oracle/10.2.0.4/client64//lib/libclntsh.so.10.1: cannot restore segment prot after reloc: Permission denied
>>> import cx_Oracle
>>>

這是因為SELinux的限制，執行如下命令取消限制：

chcon -t texrel_shlib_t cd $ORACLE_HOME/libnnz10.so

chcon -t texrel_shlib_t cd $ORACLE_HOME/libclntsh.so.10.1

五、執行時錯誤

Traceback (most recent call last):
  File "oracle_conn.py", line 9, in ?
    connection = cx_Oracle.Connection(u"oracle/[email protected]")
cx_Oracle.InterfaceError: Unable to acquire Oracle environment handle

還是SELinux的限制，設定SELinux為disabled

   關掉selinux：  

   執行命令：  vim /etc/selinux/config
   將selinux=enforcing或permissive改成disabled
   執行命令：  setenforce 0

六. UNICODE的安裝包有問題

Traceback (most recent call last):
  File "./oracle_conn.py", line 22, in ?
    folderIds=cursor.fetchmany(10)
cx_Oracle.DatabaseError: OCI-22061: Message 22061 not found; No message file for product=RDBMS, facility=OCI; arguments: [T

目前發現5.0.3版的包在執行SQL時會導致報錯，不建議使用，換成非UNICODE的包就沒問題了。