Solr 环境搭建

封面图 • 2025-11-23 • Java

搭建 Solr 环境通常涉及以下几个步骤：安装 Java、下载并配置 Solr、启动 Solr 服务、创建核心（Core）以及验证是否正常运行。以下是详细的 Solr 环境搭建指南，适用于 **Solr 8.x 或 9.x** 版本。

---

## 🧰 一、准备工作

### 1. 安装 Java
Solr 需要 Java 环境支持，推荐使用 **Java 8 或更高版本**（如 OpenJDK 11/17）。

#### Linux/macOS：
```bash
# Ubuntu/Debian
sudo apt update
sudo apt install openjdk-11-jdk -y

# macOS (Homebrew)
brew install openjdk@11
```

#### Windows：
下载 [OpenJDK](https://adoptium.net/) 并安装，设置 `JAVA_HOME` 环境变量。

---

## 📦 二、下载 Solr

从 [Apache 官网](https://solr.apache.org/downloads.html) 下载最新版本的 Solr。

例如，下载 Solr 9.0.0：

```bash
wget https://dlcdn.apache.org//solr/solr/9.0.0/apache-solr-9.0.0.zip
unzip apache-solr-9.0.0.zip
cd apache-solr-9.0.0
```

---

## 🚀 三、启动 Solr

### 方法 1：使用内置 Jetty 启动（推荐）

```bash
./bin/solr start -e cloud
```

> `-e cloud` 表示以集群模式启动（适合开发环境），如果只是单机使用可以省略该参数。

或者直接启动：

```bash
./bin/solr start
```

默认访问地址：[http://localhost:8983/solr](http://localhost:8983/solr)

---

### 方法 2：使用外部 Tomcat 部署（可选）

将 `solr.war` 文件部署到 Tomcat 的 webapps 目录中：

```bash
cp server/webapp/solr.war $TOMCAT_HOME/webapps/
```

然后启动 Tomcat 即可访问 Solr。

---

## 🗂️ 四、创建 Solr Core（索引库）

### 方法 1：通过命令行创建

```bash
./bin/solr create_core -c mycore -d example/solr/configsets/sample_techproducts_configs
```

### 方法 2：通过 Web 界面创建

访问 [http://localhost:8983/solr](http://localhost:8983/solr)，点击 "Core Admin" -> "Add Core"。

---

## 📁 五、配置 Solr（可选）

Solr 的配置文件位于：

```
example/solr/mycore/conf/
```

主要配置文件包括：

- `schema.xml`：定义字段类型和结构
- `solrconfig.xml`：定义索引、查询等行为
- `stopwords.txt`：停用词列表

---

## 📤 六、导入数据（可选）

可以使用 `post` 工具导入 JSON 或 XML 数据：

```bash
./bin/post -c mycore example/exampledocs/*.xml
```

或使用 `curl` 提交数据：

```bash
curl -X POST -H 'Content-Type: application/json' --data-binary @exampledocs/books.json http://localhost:8983/solr/mycore/update/json/docs
```

---

## 🧪 七、验证 Solr 是否正常运行

访问：[http://localhost:8983/solr](http://localhost:8983/solr)

查看是否有你创建的 core，并尝试搜索：

```bash
curl "http://localhost:8983/solr/mycore/select?q=*&wt=json"
```

---

## ✅ 八、常见问题

| 问题 | 解决方法 |
|------|----------|
| Java 版本不兼容 | 使用 `java -version` 检查，安装正确版本 |
| Solr 启动失败 | 查看日志：`logs/solr.log` |
| 端口被占用 | 修改 `solr.in.sh` 中的端口号 |

---

## 🧩 九、进阶配置（可选）

- 集群部署（SolrCloud）
- 增加分片（Sharding）
- 配置安全认证（SSL、权限控制）
- 使用 Zookeeper 管理集群

---

## 📚 参考文档

- [Solr 官方文档](https://solr.apache.org/guide/)
- [Solr Cloud 教程](https://solr.apache.org/guide/8_11/solr-cloud.html)

---

如果你需要的是 **Windows 环境下的 Solr 搭建**，或者 **SolrCloud 集群搭建**，也可以告诉我，我可以提供更详细的步骤。