tl;dr
表題の通り.本稿公開時点でPRはマージ済みだが,リリース待ちの状態である.
本稿では,発生した症状とその切り分け,応急処置,およびRails公式における修正状況を整理する.
概要
調査の結果,curlとブラウザの挙動差はWindowsとWSL間の通信環境に起因するものではなく,単にリクエストにCookieを含んでいるか否かによるものであった.さらに追究したところ,根本的な原因はRailsとjson gemの互換性問題に行き着いた.
発生環境
- Rails: 8.1.3.1
- json gem: 3.0.2
- 実行環境: WSL2 (Ubuntu)
- ブラウザ: Microsoft Edge (Windows 11)
- アクセス先: http://127.0.0.1:3000/products
対象のアプリケーションは,当日に rails new で生成した最小構成のものである.
症状:curlでは成功するのにEdgeでは失敗する
WSL内部からcurlでアクセスを試みたところ,正常に応答が得られた.
curl -i http://127.0.0.1:3000/products
一方,ホスト側のEdgeから同一のURLを開くと500エラー(Internal Server Error)が返る事象に見舞われた.
直前まではEdgeでも問題なく表示できていた故,当初は自身の加えたコード変更やWSL2とのポートフォワーディング周りの不調を疑った.
切り分け:Cookieを保持するとcurlでも再現した
通常の curl <URL> は一般的なブラウザと異なり,受け取ったCookieを自動で永続化して後続のリクエストに付与することはない.
そこで,curl側でも明示的にCookieを保存・再送して挙動を追試した.
# 1回目:レスポンスヘッダからCookieを保存
curl -i -c cookies.txt http://127.0.0.1:3000/products
# 2回目:保存したCookieを付与して再送
curl -i -b cookies.txt http://127.0.0.1:3000/products
実行結果は以下の通りである.
| リクエスト | レスポンス |
|---|---|
| Cookieなし(初回アクセス) | 200 OK |
| Cookieあり(2回目のアクセス) | 500 Internal Server Error |
これにより,WSL内部からのアクセスであっても完全に再現することが確認できた.問題のトリガーとなっていたのは,ネットワーク境界ではなくセッションCookieの読み込み処理であったわけだ.
原因:JSON.parseに対する引数のシグネチャ変更
例外のスタックトレースを追うと,根本には以下の例外が存在していた.
ArgumentError: wrong number of arguments (given 2, expected 1)
従来のRails内部におけるJSONデコード処理では,概略として以下のような呼び出しが行われていた.
JSON.parse(json, options)
すなわち,JSON文字列とオプションHashを2つの位置引数として渡している.
しかし,json gem 3系においてインターフェースが変更され,オプションは明示的にキーワード引数として渡すことが要求されるようになった.
JSON.parse(json, **options)
周知の通り,Ruby(とりわけRuby 3以降)では通常のHashを位置引数として渡すことと,二重スプラット演算子 ** を介してキーワード引数へ展開することは厳密に区別される.この仕様差分によって,Rails側の呼び出しが ArgumentError を送出していたのである.
なお,公式の PR #58601 Fix compatibility with json 3.0 を参照する限り,Rails側でキーワード引数展開を行うよう修正がなされている.
なぜ商品一覧の表示でCookieを読むのか
一見,商品一覧のような単純な参照処理では明示的なセッション操作を行っていないように思われる.しかし,共通レイアウト(application.html.erb)には往々にして以下の記述が存在する.
<%= csrf_meta_tags %>
このCSRF対策用トークンを生成・取得する過程でセッションストレージへの参照が発生し,セッションCookieを復元(デシリアライズ)するフェーズで問題のJSON解析処理がトリガーされていた.
処理のシーケンスを抽象化すると以下のようになる.
商品一覧ページのレンダリング要求
→ 共通レイアウトによるCSRFメタタグの生成
→ セッションの参照
→ セッションCookieの読み込み・デシリアライズ
→ JSON.parse の呼び出し
→ ArgumentError 発生
→ 500 Internal Server Error
コントローラやビューの直接的なコードにセッション操作が露出していないため,画面周りの差分のみを追っていては原因の特定が難しかったと言える.
応急処置:json gemを3未満に固定する
修正版のRailsがリリースされるまでのワークアラウンドとして,Gemfile でjsonのメジャーバージョンを明示的に制限した.
gem "json", "< 3"
依存関係を更新する.
bundle update json
手元の環境では,Gemfile.lock のjsonが 2.21.2 にダウングレードされた.
続いて起動中のサーバープロセスを再起動する1.
変更後は,単一のGETリクエストのみならず,Cookieを保持させた状態での連続アクセスが正常に通ることを検証する必要がある.今回の環境でも,Cookie付きcurlリクエストが200 OKを返すことを以て暫定対応とした.
現状と今後の見通し
執筆時点(2026年9月)で確認したところ,Rails 8.1系の最新リリースは8.1.3.1にとどまっており,PR #58601 を含んだマイナーアップデートはまだ一般リリースされていない.
したがって,新規にプロジェクトを立ち上げる場合であっても,以下の条件が重なると容易に同現象へ遭遇する.
- 修正前のRails(8.1.3.1等)を利用している
- バージョン指定なしでBundlerを実行し,json 3系が解決・インストールされる
- セッションCookieの読み込みをはじめとするJSONデシリアライズ処理を通過する
上流のPR議論においても,修正版がタグ打ちされるまでの間はjsonを2系にペグ留めする運用が散見される.本稿の対応も,公式のパッチリリースを待つ間の一時的な防壁と位置づけるのが適切であろう.
結び
ブラウザとCLIツール(curl等)で結果が乖離する場合,通信経路や実行基盤の差異に目を奪われがちだが,まずはリクエストヘッダやCookieといった「プロトコルレベルでの前提条件」を厳密に揃えて比較することが肝要である.
-
起動済みのプロセスには変更前のgemが読み込まれているため,依存関係の更新後はサーバーの再起動も必要. ↩