Rails7项目bin/dev无法加载puma.rb配置的问题排查

问题场景 #

• 基于 Rails 7 搭建的项目，集成了 css-bundling 和 Bootstrap
• 使用 bin/dev 启动开发服务器时，Puma 无法读取 config/puma.rb 中的配置：
  • 注释 bin/dev 内的端口配置后，服务器默认绑定到 5000 端口（而非 puma.rb 设置的 3001），且绑定地址为 127.0.0.1，导致宿主机无法访问虚拟机内的服务
  • 尝试在 Procfile.dev 中直接指定加载 puma.rb（如 web: puma -C config/puma.rb），触发 undefined method 'threads' for main:Object 错误
  • 直接运行 rails s 可正常加载 puma.rb 配置
  • 目前通过在 Procfile.dev 的 web 命令后追加 -b 0.0.0.0 -p 3001 参数临时解决问题，但希望直接复用 puma.rb 配置文件

原因分析 #

bin/dev 依赖 foreman 管理进程，若直接调用 puma 二进制文件并指定配置文件，会跳过 Rails 的初始化流程。config/puma.rb 中的配置（如 threads、bind）是 Rails 封装后的 Puma 配置 DSL，只有在 Rails 环境加载完成后才能被识别，直接运行纯 Puma 命令会导致这些方法未定义，从而报错。

解决方案 #

修改 Procfile.dev 中的 web 命令，通过 Rails 启动命令来加载 Puma，确保 Rails 环境初始化后再读取 config/puma.rb：

将原命令（比如）：

web: puma -C config/puma.rb

替换为：

web: rails server

这样 bin/dev 启动时，rails server 会自动加载 config/puma.rb 中的所有配置，包括端口、绑定地址、线程数等，无需手动在命令行追加参数。

若需要临时覆盖配置（比如测试不同端口），也可以保留命令行参数，优先级会高于 puma.rb：

web: rails server -p 3002 -b 0.0.0.0

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