XWiki 12.10.5 + MySql 8.0.23 + Tomcat 9 + Windows 10安裝過程中的一些問題及其解決

幾年前用Xwiki 10 + MySql 5.7 + Tomcat 9 + Windows Server 2008 R2配合安裝過一次Xwiki，基本照着網上的教程操作就行，不記得碰到過什麼麻煩，是以做完後印象不深。最近需要再搭建一套Xwiki，操作過程中居然碰到不少坑，現将其中過程記錄如下以供後來者參考。

搭建Xwiki需要的元件

Xwiki 12.10.5安裝包：我用的從官方網站下載下傳的war包；

Tomcat 9.2：從官方網站下載下傳；

JDK: 從Oracle官網下載下傳的Java SE 8u281 JDK；

MySql：從官網下載下傳的社群版MySql community V8.0.23；

JDK和MySql的安裝順序關系不大；Tomcat最好在JDK之後，配置Tomcat的過程中會用到JDK相關的資訊；最後安裝Xwiki。安裝完每個元件後，確定該元件安裝配置正常。

1）JDK的安裝。兩點提請注意：

Xwiki正常使用需要的是JDK，而不是JRE。我的電腦是先前就安裝有JRE的，一開始以為有JRE就行，直到看到錯誤資訊提示JAVA_HOME環境變量的設定有問題，重新下載下傳安裝JDK并重新配置JAVA_HOME（我的電腦--屬性--進階--環境變量--系統變量--JAVA_HOME）後問題得到解決。這是我這次碰到的第一個坑。

JDK版本。最新的Java已經釋出到16了，但8仍然是目前最主流，引用最廣泛的。

2）Tomcat 9 的安裝

可以參考：https://www.jianshu.com/p/b98706bc716e。

可以修改/配置端口号和JAVA_HOME變量；

3）MySql的安裝和配置

 安裝過程比較正常，安裝完後記得建立xwiki資料庫和xwiki賬号并配置設定合适的權限，參考官方文檔MySQL Installation (XWiki.org)；

JDBC driver的問題：MySql5.7及最新的MySql8已經在用com.mysql.cj.jdbc.Driver，這一項其實不需要修改，但最好确認一下；

MySql驅動複制：官方war包中隻包含了5.X版本的MySql驅動，需要自己下載下傳MySql8的Connector驅動Java版（mysql-connector-java-8.0.23.jar），并複制一份到Tomcat的相關目錄中，參考我的D:\Tomcat9\apache-tomcat-9.0.44\webapps\ROOT\WEB-INF\lib。這一步是我這次爬的坑裡，最深的一個；

其它在官方文檔中提到的還有時區等，我的Hibernate.conf.xml關鍵配置供參考：

Note：安裝配置好後，一直較忙，沒能及時記錄。本文距離實際安裝配置已經過去了2個月，當時的很多細節已經記不起來，隻能記住其中的幾個關鍵點，很是遺憾。