Heroku部署Rails动态站点报H10错误 StaticController出现layout未定义异常

你遇到的undefined method 'layout' for StaticController:Class报错是StaticController的父类继承错误导致的：
你当前代码写的是class StaticController < Rails::ApplicationController，但Rails标准控制器的父类是项目初始化时自动生成在app/controllers/application_controller.rb里的ApplicationController，该类默认继承ActionController::Base，自带layout等所有控制器类方法。而Rails::ApplicationController不是Rails框架提供的标准公共API，没有内置控制器相关的类方法，调用layout false自然会报方法未定义错误，进而导致应用启动失败抛出H10崩溃日志。

• 修改app/controllers/static_controller.rb的类定义，替换为正确的父类：

class StaticController < ApplicationController
  layout false

   def index
     render file: Rails.root.join('public', 'index.html')
   end
end

• 提交代码后重新推送到Heroku：

git add .
git commit -m "fix: 修正StaticController父类继承错误"
git push heroku main # 主分支名为master则替换为master

• 部署完成后执行迁移、重启应用验证：

heroku run rails db:migrate
heroku restart

如果修改后仍有异常，可检查以下配置：

1. 确认app/controllers/application_controller.rb文件存在，没有被误删或修改
2. 校验本地和Heroku的Rails版本是否一致：本地执行rails -v，Heroku执行heroku run rails -v，版本不一致的话修改Gemfile中的Rails版本指定后重新部署
3. 你的Procfile默认环境设为了development，如果要跑生产环境可修改为web: bundle exec puma -t 5:5 -p ${PORT:-3000} -e ${RACK_ENV:-production}

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