使用Overmind启动Puma时偶尔无法通过localhost访问的问题排查

问题详情 #

本地运行Rails 7应用时，通过overmind start启动服务，Puma 5.6.5（Ruby 3.1.2-p20）会输出Listening on http://127.0.0.1:5000。正常状态下localhost:5000可访问应用，但偶尔启动后该地址无法访问，仅127.0.0.1:5000能正常访问，且部分场景下数分钟后会自行恢复。

附带Procfile内容 #

# Procfile
web: bin/rails server -p $PORT
css: yarn build:css --watch
js: yarn build --reload

排查与解决步骤 #

• 验证localhost解析状态
  终端执行ping localhost，查看返回IP是否包含127.0.0.1；再执行nslookup localhost或dig localhost，确认解析结果是否正确指向127.0.0.1或IPv6地址::1。若解析结果异常，说明DNS缓存或hosts配置存在问题。

• 检查hosts文件配置

  • Mac/Linux：打开/etc/hosts
  • Windows：打开C:\Windows\System32\drivers\etc\hosts
    确认文件中存在127.0.0.1 localhost和::1 localhost的配置，若缺失则手动添加。

• 清空本地DNS缓存

  • Mac：执行sudo dscacheutil -flushcache; sudo killall -HUP mDNSResponder
  • Linux（Ubuntu为例）：执行sudo systemd-resolve --flush-caches
  • Windows：执行ipconfig /flushdns

• 调整Puma绑定地址
  默认Rails服务器仅绑定127.0.0.1（IPv4），若localhost解析到IPv6的::1，会出现访问失败。修改Procfile的web启动命令，让Puma绑定所有可用IP：

  web: bin/rails server -b 0.0.0.0 -p $PORT
  

  这样Puma会同时监听IPv4和IPv6地址，避免因解析协议不匹配导致的问题。

• 测试IPv6访问
  若localhost解析到::1，尝试访问[::1]:5000，若无法访问则确认Puma未绑定IPv6，按上一步调整配置即可。

内容的提问来源于stack exchange，提问作者John Hinnegan