Linux安装Solr搜索引擎详细完整教程

直接说结论：Solr 8.11+ 推荐使用 bin/solr start 启动内置 Jetty，无需强行搭配 Tomcat；仅在老版本（7.x 及更早）或需要强监控、多租户场景下才考虑外置容器。

Java 版本不匹配，bin/solr start 会静默失败

如果 Solr 启动时没有报错退出，而是卡在 “Starting Solr” 无响应，或者刚启动就立刻消失 —— 八成是 Java 版本不兼容的问题。

• Solr 8.11.x 有硬性门槛：执行 java -version 输出的版本号必须包含 11.（例如 11.0.22），1.8.0_* 绝对无法通过验证。
• Solr 9.x 要求更严格，强制需要 Java 17+，且 OpenJDK 的稳定性更好。在 CentOS/RHEL 上直接运行 sudo yum install -y java-17-openjdk-devel 即可完成安装。
• 不要试图通过修改 SOLR_JAVA_HOME 来绕过版本检查 —— 该变量仅控制启动脚本读取路径，真正决定 JVM 版本的是系统 PATH 环境变量中的 java 命令，修改后依然无效。
• 验证方法很简单：执行 bin/solr start -V，第一行会显示 Using Java version: ...，如果版本不符合要求，请更换正确的 JDK。

solr home 路径设置错误，新建 core 时出现 Can't find configset '_default'

这个错误并非配置文件丢失，而是 Solr 找不到 configset 目录。默认情况下，Solr 8+ 将 server/solr 作为根 solr home —— 注意，这是一个硬编码路径，并非由环境变量动态驱动。

• 不要随意设置 SOLR_HOME：一旦 export 该变量，所有 core 都必须放在指定路径下，且该路径必须包含 configsets/_default 子目录，否则 bin/solr create -c mycore 必然会失败。
• 推荐做法是保持默认，让 Solr 自动管理 server/solr 目录；新建 core 时命令会自动在 server/solr/mycore/conf/ 下生成标准配置结构。
• 如果确实需要自定义路径，请使用 -s /path/to/home 参数（例如 bin/solr create -c mycore -s /opt/my-solr-home），不要直接修改环境变量。
• 另外，server/solr/mycore/core.properties 文件不能删除：其中的 configSet=xxx 是运行时加载的依据，删除后通过 UI 或 API 创建 core 都会失败。

中文分词器安装后未生效？不能只看插件是否加载成功

即使已将插件复制到 server/solr/configsets/_default/conf/analysis-ik/、修改了 managed-schema、重启了 Solr —— 这些操作只是“表面完成”。要验证实际效果，必须通过 analyzer 接口进行测试。

• 执行命令：curl "http://localhost:8080/solr/mycore/analysis/field?analysis.fieldname=text_general&analysis.text=北京大学"
• 重点关注返回 JSON 中的 tokens 数组：如果依然是单字切分（"北","京","大","学"），说明 IK 分词器未生效；正确结果应为 "北京大学" 或 "北京","大学"。
• 常见陷阱：schema 中字段 type 指向的 text_ik 类型未定义，或定义中的 analyzer class="org.apache.lucene.analysis.cn.smart.SmartChineseAnalyzer" 使用了旧版类名 —— Solr 8+ 已弃用 SmartChineseAnalyzer，改为使用 analysis-smartcn 插件配合 smartcn_tokenizer 实现。
• 注意端口号：默认端口是 8983，而非 8080；如果你在 solr.in.sh 中修改了 SOLR_PORT，curl 请求地址也需要同步更新。

启动后无法访问 Web UI？先检查端口和防火墙，再查看日志位置

如果浏览器打不开 http://localhost:8983/solr，不要急着重装，90% 的情况都是网络或权限问题引起的。

• 首先确认 Solr 确实在运行：执行 bin/solr status，输出中应包含 solr-8.11.2 is running 和对应的 PID。
• 检查监听端口：运行 netstat -tuln | grep :8983，没有输出则说明未成功监听；如果有输出但外部无法访问，大概率是被防火墙拦截了。
• 在 CentOS/RHEL 上执行：sudo firewall-cmd --permanent --add-port=8983/tcp && sudo firewall-cmd --reload 来开放端口。
• 日志文件不在 catalina.out：Solr 8+ 默认将日志写入 server/logs/solr.log，所有错误信息都记录在其中。启动失败时，使用 bin/solr start -f（前台模式）可以实时看到报错信息。
• 不要只局限于 localhost：远程服务器应使用服务器 IP 访问；如果 Solr 默认绑定 127.0.0.1，需要在 solr.in.sh 中将 SOLR_HOST 改为 0.0.0.0 才能实现外网访问。

复杂之处在于：Solr 启动逻辑看似简单，实际上耦合了 Java 版本、路径约定、配置加载顺序、网络绑定策略四层判断；任何一个环节偏离默认假设，都会导致“没有报错却不工作”的现象。最容易被忽略的是 server/solr 这个隐式 home 路径，以及 analyzer 接口的实测验证 —— 它们虽然不显眼，但直接决定了功能是否真正可用。