Puma启动报undefined local variable or method `daemonize'错误求助

安全阿岳

2026-10-19

问题根因

你遇到的undefined local variable or method 'daemonize'报错，核心原因是 Puma 5.0及以上版本已经正式移除了内置的daemonize配置项，该配置原先用于实现Puma后台守护运行，官方不再原生支持该功能。

解决方案

根据你的使用场景选择对应方案即可：

方案1：移除冗余配置
直接删除puma.rb中的daemonize true这一行即可解决报错。如果是开发环境，或者已经用systemd、supervisor等工具托管Puma进程，不需要依赖Puma自带的后台运行能力，选这个方案即可。
方案2：锁定Puma到4.x版本
如果必须使用daemonize配置，可以在项目Gemfile中指定Puma版本为4.x系列：
```
gem 'puma', '~> 4.3.12'
```
保存后执行bundle update puma重新安装对应版本的Puma即可。
方案3：使用系统进程管理工具替代daemonize
生产环境更推荐用Ubuntu 20.04自带的systemd托管Puma进程，可同时实现后台运行、异常自动重启、开机自启、日志统一管理等能力，稳定性远高于Puma自带的守护进程功能。