Rails 5.1.6迁移后Sunspot/Solr连接拒绝问题求助

嘿，我之前在把项目从Rails 4迁到5.1.x的时候也碰到过几乎一模一样的Sunspot问题——明明显示Solr启动成功，一操作就报RSolr::Error::ConnectionRefused: Connection refused，折腾了好一阵才搞定，给你分享几个排查方向：

• 先确认Solr真的在运行：
  别光信Sunspot的启动提示，手动检查端口和进程。在终端里跑lsof -i :8983或者netstat -an | grep 8983，看看有没有进程在监听8983端口。如果没结果，说明Solr根本没真正启动，可能是Sunspot的启动脚本出了问题，试试直接用Solr的原生启动命令启动（比如solr start -p 8983），再看能不能连接。

• 核对Solr Core路径与配置匹配：
  你的配置里path是/solr/default（开发/生产）和/solr/test，但要确认Solr真的有这两个core。去Solr的安装目录下的server/solr文件夹看看，有没有default和test的文件夹；或者如果能打开Solr Admin页面，在左侧Core Selector里看看有没有对应的core。如果没有，得手动创建对应的core，或者修改配置里的path指向存在的core。

• 检查Sunspot版本与Rails 5.1.6的兼容性：
  Rails 5对gem的兼容性要求更严，老版本的Sunspot可能不兼容。看看你的Gemfile里sunspot和sunspot_rails的版本，建议升级到sunspot_rails (~> 2.4.0)（这个版本对Rails 5.x支持比较好），然后跑bundle install，重启Solr和Rails试试。

• 校验YAML配置的缩进正确性：
  YAML对缩进超级敏感，哪怕多一个少一个空格都会导致配置不生效。你贴的配置看起来没问题，但还是手动核对一下：每个层级（比如production下的solr，solr下的hostname）都用两个空格缩进，不要用tab。可以把配置粘到本地编辑器里，开启显示空格的功能检查。

• 排查网络/防火墙/Hosts问题：

  • 试试把配置里的hostname: localhost改成hostname: 127.0.0.1，有时候localhost的hosts配置被修改，指向了非本地地址。
  • 检查本地防火墙（比如Linux的ufw/iptables，Mac的防火墙）有没有挡住8983端口，临时关闭防火墙试试能不能连接。如果是云服务器的生产环境，还要检查安全组有没有开放8983端口的入站规则（不过生产环境建议不要直接暴露Solr端口，最好用本地连接）。

• 查看Solr日志找深层错误：
  如果上面都没问题，去Solr的日志目录（一般是server/logs/solr.log）看看有没有报错。比如Solr启动时内存不足、core加载失败、权限不够等，这些问题可能不会在Sunspot的启动提示里显示，但会导致Solr无法正常响应连接。

内容的提问来源于stack exchange，提问作者Bharat Hegde