生产环境必须用Tomcat部署Solr而非bin/solr脚本，因Jetty存在监控集成难、JVM调优受限、多core类加载不稳定三大硬伤；需严格配置solr/home绝对路径、复制ext/metrics/log4j2三类JAR，并验证中文分词器实际分词效果。
直接在 Linux 上装 Solr，别用自带的 solr 脚本跑 Jetty（开发够用，生产扛不住），必须绑定到 Tomcat 这类成熟 Servlet 容器——否则连基本的线程池、连接复用、日志隔离都控制不了，一上量就 502 或 OOM。
为什么不能直接用 bin/solr start
Solr 自带的启动脚本本质是封装了 Jetty，适合单机调试，但存在三个硬伤：
- 无法与企业已有 Tomcat 监控体系（如 JMX、APM）集成
- Java 参数（如
-Xms/-Xmx）和线程模型被 Jetty 层级硬编码，调优困难 - 多 core 场景下，
solr.xml的sharedLib加载逻辑在 Jetty 下不稳定，容易出现ClassNotFoundException
真实生产环境（尤其美国 VPS 或香港 VPS）必须走 WAR + 外置容器路径。Solr 8.11+ 已移除 solr-webapp/webapp 目录，改用 server/solr-webapp/webapp，这点极易踩坑。
solr.xml 中 solr/home 的路径必须绝对且可读
Tomcat 启动后，Solr 会按 solr/home 环境变量定位核心配置和索引目录。这个路径不是相对路径，也不是“当前工作目录”，而是 Tomcat 进程用户（如 tomcat）有权限读写的绝对路径。
- 推荐设为
/var/solr/home，创建时执行：sudo mkdir -p /var/solr/home && sudo chown -R tomcat:tomcat /var/solr - 在
webapps/solr/WEB-INF/web.xml中，必须显式声明：<env-entry-value>/var/solr/home</env-entry-value> - 若路径含空格或中文，Tomcat 会静默失败，只报
SEVERE: Error filterStart，不提示具体原因
必须复制的三类 JAR 包缺一不可
Solr WAR 包本身不包含全部依赖，漏掉任意一类都会导致启动失败或功能缺失：
-
server/lib/ext/*.jar：基础扩展包，含solr-dataimporthandler-*.jar，漏掉则 DIH（数据导入处理器）无法加载 -
server/lib/metrics-*.jar：监控指标支撑，缺它会导致/solr/admin/metrics接口返回 404 -
server/resources/log4j2.xml：必须拷贝到WEB-INF/classes/，否则日志全打到catalina.out，无法按 level 分离
注意：Solr 9 开始弃用 log4j2.xml，改用 log4j2.properties，但目前主流生产环境仍为 Solr 8.x，坚持用 XML。
中文分词器安装后要验证 analyzer 是否生效
装完 analysis-ik 或 analysis-smartcn 插件后，不能只看插件是否加载成功，必须实测分词效果：
- 用
curl "http://localhost:8080/solr/mycore/analysis/field?analysis.fieldvalue=搜索引擎优化&analysis.fieldname=text_general" - 响应中
tokens数组应出现“搜索”“引擎”“优化”等合理切分，而非单字或整串 - 若返回空或报错
"error":{"msg":"Unknown tokenizer type [ik_max_word]"，说明插件 JAR 没放对位置（必须在WEB-INF/lib/，不能只丢在server/lib/）
真正难搞的不是安装步骤，而是每个环节的权限、路径、JVM 用户上下文三者咬合——Tomcat 以 tomcat 用户运行，/var/solr/home 必须归它所有，JAR 包的 MANIFEST.MF 里 Class-Path 不能含相对引用，否则启动瞬间就挂。
