🧑‍💻

入社前だけど3,000万MAUのサービスをRails8.0にアップグレードしちゃいました

Yagi

2025/03/25に公開2件

はじめに

株式会社マイベストに2025年度入社予定のYagiです！一年前からバックエンドエンジニアとして内定者インターンに取り組んでいます。今回、マイベストで使用されているRuby on Railsを7.2から8.0にアップグレードしたので、その手順や遭遇した問題点などをまとめています。

アップグレード手順

Gemのバージョンを最新にする
アップデートタスクを実行
新たに発生するようになったエラーへの対処
フレームワークのデフォルトを設定
QA環境にデプロイして動作確認する
本番環境にデプロイ

Gemのバージョンを最新にする

Railsのアップグレード作業に入る前に、Rails以外のGemバージョンを最新にします。これは、Rails本体の変更だけでなく、依存するGemの変更による影響も最小限に抑えるためです。

マイベストでは、Dependabotを導入し、普段からGemの依存関係を管理しています。そのため、差分もあまりなく、比較的スムーズに最新バージョンへの更新作業を行うことができました。
各GemのChangelogで破壊的変更を確認し、プルリクエスト上でも表にまとめておきます。

開発環境・テスト環境のGemと本番環境のGemでリリースを分けることで、リリース時の影響を最小限に抑えました。

bundle update -g development -g test

アップデートタスクを実行

Gemのアップデートが完了したので、Railsを8.0に上げていきます。

- gem 'rails', '~> 7.2'
+ gem 'rails', '~> 8.0'

$ rails app:update

設定ファイルなど、手作業での修正が必要な箇所は、Rails Diffなどのサイトで差分を確認しながら慎重に作業し、意図しない変更や設定ミスを防ぎました。

新たに発生するようになったエラーへの対処

Railsのバージョンアップに伴って、新たなエラーや警告が追加されたので、該当箇所を修正します。

ルーティングエラー

↓のリリースにより、ルーティング設定において、存在しないメソッドをonlyまたはexceptオプションで使用した場合、ArgumentErrorが発生するようになったようです。

エラーメッセージに従ってonlyオプションを書き換えました。

-  resource :user, only: :none do
+  resource :user, only: [] do

RSpecエラー

次に、CIのRSpecテストでは2種類のエラーが大量に発生していました。

↓のリリースにより、STATS_DIRECTORIESの定義方法が変わったことで、2回目以降の実行時はエラーを吐くようになりました。

挙動をコンソールで確認

そして、このSTATS_DIRECTORIESが定義されているファイルはtasksディレクトリ内に配置されていたため、タスクの過剰な読み込みが発生していると予測。

確認したところ、各テストグループの開始前に毎回タスクがロードされていました。
テストスイートの開始時に一度だけ行えば良いので、before(:suite)に移します。

spec/spec_helper.rb
  config.before(:suite) do
+    Rails.application.load_tasks
  end

  config.before(:all) do
-    Rails.application.load_tasks
  end

やはりこれが原因でした。

また、各テストファイルでもさらにタスクをロードしてしまっていたので、まとめて削除します。

spec/lib/tasks/hoge_spec.rb
RSpec.describe 'hoge_task' do
-  before(:all) do
-    @rake = Rake::Application.new
-    Rake.application = @rake
-    Rake.application.rake_require 'tasks/hoge'
-    Rake::Task.define_task(:environment)
-  end
  # ...
end

フレームワークのデフォルトを設定

Rails8.0では新たに3つのデフォルト設定が追加されました。

Rails.application.config.active_support.to_time_preserves_timezone = :zone
Rails.application.config.action_dispatch.strict_freshness = true
Regexp.timeout = 1

どれも軽微な変更ですが、対応が必要ないことが確認できたらload_defaultsを上げて設定を適用します。

config/application.rb
class Application < Rails::Application
  # Initialize configuration defaults for originally generated Rails version.
-   config.load_defaults 7.2
+   config.load_defaults 8.0
  # ...
end

また、レビューしやすいよう、これらの設定について概要や挙動の違いをNotionにまとめました。

↓詳細はこちら

デフォルト設定の変更点

 1.  active_support.to_time_preserves_timezone = :zone

 概要to_time メソッドがタイムゾーンを保持するか、UTCオフセットを保持するかを制御します。

 設定オプション:
:zone: タイムゾーンを保持

:offset: UTCオフセットを保持

false: ローカルシステムのUTCオフセットに変換
以前までデフォルトで :offset だったのが、8.0で:zone になりました。

https://edgeguides.rubyonrails.org/configuring.html#config-active-support-to-time-preserves-timezone

 コンソールでの両者の挙動::offset (7.2 以前)

:zone (8.0 以降)

今後はTimeオブジェクトからタイムゾーン情報も参照できるようになり、より正確な時間情報の扱いが可能になります。

 2. action_dispatch.strict_freshness = true

 概要HTTP ヘッダーの If-Modified-Since と If-None-Match に基づいてリソースが変更されたかどうかを判断する際の挙動を制御します。

 設定オプション:
true:

両方のヘッダーが存在する場合、If-None-Matchのみが考慮されます。

false:

両方のヘッダーが存在する場合、両方のヘッダーがチェックされます。
https://edgeguides.rubyonrails.org/configuring.html#config-action-dispatch-strict-freshness

Rails 8.0以降では、RFC 7232に準拠するように、デフォルト値がtrueに変更されました。

 3. Regexp.timeout ||= 1

 概要ReDoS 対策のため、 Regexp.timeout にデフォルトで1秒をセットします。

https://rubyonrails.org/2024/11/1/this-week-in-rails
正規表現に1秒以上かかる場合はタイムアウトエラーが発生するようになるので、必要に応じて設定値を変更する必要があります。
Regexp::TimeoutError: regexp match timeout