Tomcat 部署 Solr 4.10.4 完整步驟：避開 5.x 版本坑位的穩健方案

版本選型背景

Solr 5.x 重大變更：目錄結構調整、內嵌 Jetty 替代 WAR 部署、中文分詞器（IK Analyzer）兼容性破壞。生產環境選擇 4.10.4（4.x 最後版本）穩健可控。

環境準備

• JDK 1.7+（4.10 強制要求）
• Tomcat 7/8（推薦 8.5+）
• Solr 4.10.4 分發包：solr-4.10.4.tgz

部署 8 步走

1. 解壓分發包：得到 solr-4.10.4/ 目錄
2. 部署 WAR：複製 example/webapps/solr.war → tomcat/webapps/
3. 自動解壓：啟動 Tomcat 讓其解壓 WAR，隨後停止並刪除 solr.war（防重複解壓）
4. 創建 Solr Home：如 D:/data/solr，複製 example/solr/* 至此
5. 配置數據目錄：修改 D:/data/solr/collection1/conf/solrconfig.xml

   <dataDir>${solr.data.dir:D:/data/solr/collection1/data}</dataDir>

6. 配置 JNDI Home：修改 tomcat/webapps/solr/WEB-INF/web.xml

   <env-entry>
       <env-entry-name>solr/home</env-entry-name>
       <env-entry-value>D:/data/solr</env-entry-value>
       <env-entry-type>java.lang.String</env-entry-type>
   </env-entry>

7. 補全依賴 JAR：複製 example/lib/ext/*.jar → tomcat/webapps/solr/WEB-INF/lib/
8. Log4j 配置：在 tomcat/webapps/solr/WEB-INF/ 創建 classes/，複製 example/resources/log4j.properties 至此

驗證訪問

啟動 Tomcat，瀏覽器打開 https://localhost:8080/solr，應看到 Solr Admin Dashboard（Collection1 可用）。

常見報錯與解決

生產化建議

• 獨立 Solr 服務器（非與應用共用 Tomcat）
• 配置 JVM 參數：-Xms2g -Xmx4g -XX:+UseG1GC
• 啟用 Solr 日誌輪轉、慢查詢日誌
• 定期備份 data/index 目錄
• 監控：JMX + Prometheus + Grafana 看板