Eclipse 中運行 Solr 完整實戰指南：從項目創建到管理面板訪問

Solr 核心認知

• Solr = 基於 Lucene 的開箱即用搜索服務器
• 本質：可部署在 Servlet 容器（Tomcat/Jetty）中的 Web 應用
• 核心能力：索引管理 + 全文搜索，提供 REST API、管理 UI、分佈式擴展

環境準備

1. 下載 Solr 完整包（示例版本：3.6.1）
2. Eclipse 安裝 Web Tools Platform (WTP) 插件
3. 配置 Tomcat/Jetty 運行時環境

步驟 1：創建 Dynamic Web Project

• Project name: solr（影響訪問路徑 /solr）
• Target runtime: Apache Tomcat 7.0+
• Configuration: Default Configuration for Apache Tomcat

步驟 2：部署 Solr WAR 包

# 解壓 apache-solr-3.6.1.war
cd apache-solr-3.6.1.war
jar -xf apache-solr-3.6.1.war

# 將所有內容複製到 WebContent 目錄覆蓋
cp -r * /workspace/solr/WebContent/

忽略初期紅叉錯誤（缺少依賴 JAR），後續步驟會解決。

步驟 3：配置 solr.home (核心配置目錄)

編輯 WebContent/WEB-INF/web.xml，在 <web-app> 內添加：

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

• env-entry-name 必須為 solr/home
• env-entry-value 為絕對路徑，存放核心配置與索引數據

步驟 4：準備 Solr Core 配置文件

方案 A：複製官方示例 (MultiCore)

# 從解壓包複製
cp -r example/multicore/core0 /E:/solr/merchant
cp example/multicore/solr.xml /E:/solr/

方案 B：手動創建最小配置

1. solr.xml (放在 E:/solr/)

<solr persistent="false">
    <cores adminPath="/admin/cores">
        <core name="merchant" instanceDir="merchant" />
    </cores>
</solr>

2. 目錄結構

E:/solr/
├── solr.xml
└── merchant/
    └── conf/
        ├── schema.xml      # 字段類型、索引結構定義
        └── solrconfig.xml  # 請求處理器、緩存、提交策略配置

若不熟悉配置，直接複製 example/multicore/core0/conf/ 下兩文件。

步驟 5：Eclipse 配置 Tomcat 並啟動

1. Servers 視圖 → New → Server → Apache Tomcat
2. Add and Remove → 將 solr 項目添加到右側
3. 雙擊 Server → Ports 區 → HTTP/1.1 端口改為 8983（避免衝突）
4. Save → Start Server

步驟 6：訪問管理面板驗證

瀏覽器打開：https://localhost:8983/solr/

• 左側 Core Selector 下拉選中 merchant
• 進入 Dashboard、Query、Schema、Dataimport 等功能頁

常見問題排查

版本升級提示

• Solr 4.0+ 引入 SolrCloud、ZooKeeper 分佈式模式
• Solr 5.0+ 內嵌 Jetty，可獨立運行 bin/solr start，無需外部容器
• Solr 7.0+ 模塊化架構，配置簡化，建議新項目直接使用 8.x/9.x LTS 版本