weblogic 部署問題定位與解決

   weblogic 作爲商用中間件在(EJB、jndi 數據源、日誌管理、內存管理、資源配置管理...)  是一些開源免費小型容器沒法望其項背的。

   weblogic 最先由 weblogic Inc. 開發，後併入 BEA  公司，最終 BEA 公司又併入 Oracle 公司。

   weblogic 是用於開發、集成、部署和管理大型分佈式 Web 應用、網絡應用和數據庫應用的 Java 應用服務器。

   所以 weblogic 通常作爲項目上線發佈和部署的服務器，而本地研發時大多會選用 Tomcat/Jetty.... 小型容器。

   這樣不免會出現問題，本地運行良好的 web 程序，部署在 weblogic 時會出現這樣或那樣的問題。

   絕大一部分問題都是由於 weblogic 依賴的 jar 與項目中的 jar 衝突（相同 jar 不一樣版本）或 weblogic 不支持項目 jar 所致使的。

   當部署 weblogic 出現問題時（本身總結三板斧）：

   1. 確認公司使用的 weblogic 版本並翻閱官網對應 weblogic 版本所支持的標準；

   2. 對照 weblogic 出錯日誌肯定衝突 jar 或肯定該 webloigc 不支持的 jar；

   3. 對於出現衝突的 jar 在項目 WEB-INFO 目錄下添加 weblogic.xml 配置文件，其中申明要預先加載的項目 jar;

   4. 對於出現該 webloigc 版本不支持的 jar,升級 weblogic 版本，或下降項目使用的 jar 版本。

1. 肯定 weblogic 版本並查看相應支持的標準

   知已知彼才能百戰不殆，因 weblogic 小版本較多且版本之間差別較大。

   查看 weblogic 版本有不少方法，最直接方式是詢問安裝 weblogic 的同事，或者登陸到 linux 像下面這樣。

   獲悉部署的版本後，去瞅瞅 oracle weblogic 官網，那裏的文檔資料是最全面也是最權威的。

   http://www.oracle.com/technetwork/middleware/weblogic/documentation/index.html

   

   找到對應版本點 view Library 跳轉進去，裏面是整個版本的概覽，我們的關注點應該是該  weblogic 版本支持的標準。

   

   裏面有詳細的該 weblogic 支持的 java、web Service、一些雜七雜八的標準，好比 JDK、EL、Servlet、JAX-RS、JAX-WS....

2. 定位問題

   有了上述具體的支持標準，配合部署報錯的具體類和方法，就能夠對症下藥。

   下面列舉部署 weblogic 時常見的幾個報錯異常(還有不少遇到在補充)：

   01) java.lang.UnsupportedClassVersionError:  Unsupported major.minor version 51.0 

   weblogic Jdk 版本與項目 jdk 版本不一致

   02) request.getRealPath() 爲 null 

   servlet-api.jar 本地和 weblogic 有差別，使用類加載 Thread.currentThread().getContextClassLoader() 獲取相對路徑；

  （classpath 下找不到 .doc 和 .exe ？能夠讀取配置文件？）將資源放置到 WEB-INF 下；

   03) ClassNotFoundException：org.hibernate.hql.ast.HqlToken

   weblogic 已依賴較早版本的 antlr.jar

   04) 統一配置 tomcat 和 weblogic 上的數據源

<jee:jndi-lookup id="dataSource" jndi-name="jdbc/user" />

   05) java.lang.ClassCastException: weblogic.xml.jaxp.RegistryDocumentBuilderFactory cannot be cast to javax.xml.parsers.DocumentBuilderFactory

   移除項目 xml-apis.jar 或 jaxp-api.jar

   06)weblogic NoClassDefFoundError: Could not initialize class sun.awt.X11Graphi

   修改 startWebLogic.sh export JAVA_OPTIONS=-Djava.awt.headless=true

   07)weblogic.jdbc.wrapper.Clob_oracle_sql_CLOB cannot be cast to oracle.sql.CLOB 

   使用 weblogic JNDI 數據源讀取 clob 字段時出現的強轉錯誤:http://blog.csdn.net/arvinrong/article/details/22732219

   08) java.lang.NoSuchMethodError: com.google.common.collect.Lists.reverse(Ljava/util/List;)Ljava/util/List

   weblogic 依賴的 guava 版本較低(包含14.0.1 及如下)

   09)WebLogic下使用 URL.openConnection 獲取鏈接返回 SOAPHttpsURLConnection 而不是 HttpsURLConnection

   在實例化 URL 對象是指定JDK Handler new URL(null, urlStr, new sun.net.www.protocol.http.Handler.Handler())

   10)java.lang.LinkageError: loader constraint violation: when resolving method'XXXXX(XXXX)V'

    weblogic 類加載器和 JVM 類加載器加載了不一樣 Jar 的相同類致使衝突(刪除XXX所在jar)：http://www.lxway.com/981865964.htm

   11)java.lang.NoSuchMethodError: javax.validation.spi.ConfigurationState.getParameterNameProvider()Ljavax/validation/ParameterNameProvider

    weblogic 依賴的 hibernate-validator 版本較低(包含 4.3.2.Final 及如下)

   12)java.lang.AbstractMethodError: org.hibernate.validator.internal.engine.ConfigurationImpl.getDefaultParameterNameProvider()Ljavax/validation/ParameterNameProvider;

    升級 hibernate-validator 版本

   13)java.lang.RuntimeException: Invalid schema document passed to AbstractDataBinding.addSchemaDocument, not in W3C schema namespace: schema

    com.sun.xml.bind.jaxb-impl 與 weblogic JDK jar 衝突，排除該 jar

   14)weblogic 解析 web.xml 時不支持通配符，相似於這種:spring-mvc*.xml

3. 解決方法

   解決此類問題的方式大致有三種，遇到部署問題時也能夠本身都實踐一下。

a. 刪除 weblogic 下衝突 jar 文件夾:

   （1）刪除 /bea/weblogic12.1.3/server/lib/weblogic.jar中的衝突的文件夾;

   （2）copy 衝突的 XXX.ja r到 /bea/weblogic12.1.3/server/lib, 重啓weblogic。

b.  經過修改啓動腳原本優先加載某些 jar

  （1）將衝突的 jar 包拷貝到 ${DOMAIN_HOME}/lib 目錄下。

  （2）${DOMAIN_HOME}/bin 下找到 startWeblogic.sh 文件用文本編輯器將其打開，並在裏面加入以下內容：

export first_classpath=${DOMAIN_HOME}/lib/xxxx.jar  
SAVE_CLASSPATH="${first_classpath}:${CLASSPATH}"  

c. 在應用中經過 weblogic .xml 的配置，優先加載應用的 jar

   因 weblogic 版本不用，weblogic 的配置項會有差別，不要盲目從網上 copy。

   官網版本描述（其餘版本將1213換一下便可）：http://docs.oracle.com/middleware/1213/wls/WBAPP/weblogic_xml.htm#WBAPP571

   關注其中的 prefer-application-resources/prefer-application-packages（預先加載應用對應 jar ） 節點的配置：

<?xml version="1.0" encoding="UTF-8"?>
<weblogic-web-app xmlns="http://xmlns.oracle.com/weblogic/weblogic-web-app">
    <container-descriptor>
        <prefer-web-inf-classes>false</prefer-web-inf-classes>
        <prefer-application-packages>
            <package-name>預先加載項目 lib 中的包名，支持通配符</package-name>
            <package-name>com.sun.faces.*</package-name>
            <package-name>com.bea.faces.*</package-name>
        </prefer-application-packages>
    </container-descriptor>
</weblogic-web-app>

  解決方案 a/b/c 中， c 方案無異是最優解，作爲生產環境的 weblogic 可能會部署多個應用，不太可能讓你隨便重啓。

  方案 a,b 會破壞 weblogic 的總體性，可能致使其餘部署在 weblogic 上的應用出現問題。