如何在启动及进程终止时记录系统状态？Puma环境下相关问题咨询

一、启动流程中何时可访问日志记录器 #

• Puma 启动时，日志记录器在核心组件初始化完成后即可访问，分两种场景：
  • 纯 Puma 配置（config/puma.rb）：从配置文件开头就能直接使用内置的 logger 变量输出日志，比如在配置端口前就可以写 logger.info "Puma 日志系统已初始化，开始加载配置"。
  • Rails + Puma 组合：若要调用 Rails.logger，需等 Rails 基础环境初始化完成——通常在 config/puma.rb 的后半段，或者放在 before_fork 钩子之后，避免因 Rails 日志系统未就绪报错。如果要更早记录，优先用 Puma 自带的 logger。

二、如何判断应用已加载完成 #

针对 Puma 托管的 Rails 应用，推荐这几种可靠方式：

• 使用 Puma 的 on_worker_boot 钩子：这个钩子会在每个工作进程启动完毕、应用代码全量加载后触发，是记录“应用加载完成”状态的最优时机，示例代码：

  on_worker_boot do
    logger.info "工作进程 #{Process.pid} 启动完成，应用已就绪"
    # 在这里执行系统状态记录逻辑
  end
  

• 监听 Rails 的 after_initialize 回调：在 config/application.rb 中添加该回调，它会在 Rails 所有核心组件初始化完成后触发，适合记录应用层面的加载状态：

  config.after_initialize do
    Rails.logger.info "Rails 应用核心模块加载完成"
  end
  

• 外部进程检查：通过 pumactl status 命令可以查看 Puma 主进程是否处于 started 状态，适合外部监控脚本判断，但不适合代码内的状态记录。

补充：进程终止阶段的状态记录，可借助 Puma 的 on_worker_shutdown 钩子，在工作进程关闭前完成日志写入。

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