【JS・フロントエンド】Node 26→27 移行ログ — alpha で実測、実際に壊れた3箇所と直し方

Node 26→27 移行ログを表したアイキャッチ画像
目次

Node 26 で動いていた API が 27 で落ちたときの直し方

この記事が向いている悩みです。

  • Node.js 27 に上げたら req.headers.hasOwnProperty is not a function でサーバーが落ちた
  • crypto を呼んでいる箇所が ERR_UNKNOWN_ENCODING を吐くようになった
  • V8 15.6 の新機能を、いま動いている LTS と比べながら試したい

対象読者: Node.js で API サーバーや CLI を運用している人です。前提知識: node:http と node:crypto の基本 API に触れたことがあること。

結論

Node.js 27.0.0-alpha(2026-10-29 リリース)に 26 系のコードを載せ替えると、少なくとも次の 3 箇所で壊れました。

  • req.headers が null プロトタイプに。ミドルウェア由来の hasOwnProperty() 直撃で TypeError になります
  • crypto のエンコーディング検証が厳格に。無効な encoding が ERR_UNKNOWN_ENCODING で落ちます
  • Hmac.digest() の 2 回目呼び出しが runtime 非推奨(DEP0206)に

直し方はどれも小さいです。26 でも動く書き方に置き換えるだけで済みます。本記事のコードは「検証環境」に記したとおり、隔離した Windows 上で Node v26.13.0 と v27.0.0-alpha.0.0.0 を実際に実行して確認したものです。

検証対象は alpha 版です。Node.js 27 の正式リリースは 2027 年 4 月、LTS 化は 2027 年 10 月の予定です。alpha の挙動は今後変わる可能性があります。

壊れた箇所1: req.headers が null プロトタイプに

http.createServer のコールバックで受け取る req.headers が、27 から null プロトタイプのオブジェクトになりました。壊れるのはこういうコードです。

const http = require('node:http');

const server = http.createServer((req, res) => {
  // Node 26 まで動いていた書き方
  const hasAuth = req.headers.hasOwnProperty('authorization');
  res.end(JSON.stringify({ hasAuth }));
});

実行結果(Node 27): TypeError: req.headers.hasOwnProperty is not a function。26 では headers が普通のオブジェクトだったので、メソッドがそのまま生えていました。

直し方は Object.hasOwn() か in 演算子です。26 / 27 どちらでも動きます。

const server = http.createServer((req, res) => {
  // 26 / 27 どちらでも動く
  const hasAuth = Object.hasOwn(req.headers, 'authorization');
  res.end(JSON.stringify({ hasAuth }));
});

なお「headers 全体をログに出す」用途なら影響ありません。壊れるのはプロトタイプのメソッドに直接触る書き方だけです。

壊れた箇所2: crypto のエンコーディング検証が厳格に

digest() や update() に無効な encoding を渡したときの挙動が変わりました。次のコードは 26 まで動いていました。

const crypto = require('node:crypto');

// 「文字列が返る」と思い込んでいた古いコード
const out = crypto.createHash('sha256').update('abc').digest('utf8');

実行結果(Node 26): 黙って 32 バイトの Buffer を返します。ここに文字列化の期待を載せるとデータが壊れる、かなり危険な黙り込みでした。実行結果(Node 27): ERR_UNKNOWN_ENCODING - Unknown encoding: utf8 で即例外です。

文字列が欲しいなら digest('hex') を指定します。次は 26 / 27 どちらでも意図どおり動きます。

const out = crypto.createHash('sha256').update('abc').digest('hex');
// 実行結果: ba7816bf8f01cfea414140de5dae2223b00361a396177a9cb410ff61f20015ad

壊れた箇所3: Hmac.digest() の 2 回目が非推奨に

まだ例外にはなりませんが、runtime deprecation が出るようになったので挙げておきます。

const crypto = require('node:crypto');

const h = crypto.createHmac('sha256', 'secret');
h.update('data');
h.digest();

h.digest(); // 2 回目を呼んでいるコード

実行結果(Node 27): DeprecationWarning [DEP0206] Calling Hmac.digest() more than once is deprecated.。動作自体は今のところ維持されますが、次のメジャーで消える公算があります。

ハッシュ値を複数回必要とするなら、createHmac() を都度作り直すのが定石です。

壊れなくても挙動が変わる 2 点

移行前に知っておきたい挙動差はこの 2 つです。

  • HTTP keep-alive の既定値が 5 秒から 65 秒に
  • v8.serialize() / structuredClone() のシリアライズ形式が新しくなり、旧 Node では読めない
const http = require('node:http');

const server = http.createServer();
console.log(server.keepAliveTimeout);
// 実行結果: Node 26 → 5000 / Node 27 → 65000

keepAliveTimeout はサーバー側の既定値です。クライアントや LB の待機時間とずれると「途中で切れた」挙動の原因になるので、運用中なら明示しておくのが安心です。

const v8 = require('node:v8');

const buf = v8.serialize({ hello: 'node27' });
console.log(buf.subarray(0, 4).toString('hex'));
// 実行結果: Node 26 → ff0f6f22 / Node 27 → ff106f22

シリアライズ形式の方はバージョンバイトが上がっているのが分かります。27 が書いたペイロードを 26 が読むと失敗するので、Redis やメッセージキューにキャッシュを持っている場合は混在期に注意です。

加えて V8 のヒープ上限の計算も変わり、Buffer / ArrayBuffer の占有分も上限に含まれるようになりました。--max-old-space-size を明示していないアプリは、上限の見直しをしておきましょう。

新リリースモデルとうれしい新機能

27 は Node.js の新しいリリースモデルの最初のバージョンです。2026 年 10 月から年 1 回のメジャーリリース(4 月)に変わり、全リリースが LTS になる流れになりました。

  • Math.sumPrecise() — 大きい数が混ざる合計の誤差を抑える(V8 15.6)
  • Iterator.zip() / zipKeyed() / join() / includes() — イテレータ操作の新 API
  • --allow-env — permission model で環境変数へのアクセスを制御する新フラグ
// V8 15.6 で既定有効になった新機能
const xs = [1e20, 1, -1e20];

console.log(xs.reduce((a, b) => a + b, 0)); // 実行結果: 0(1 が消える)
console.log(Math.sumPrecise(xs));          // 実行結果: 1

集計で 1 が消える挙動、経験ある人は多いはずです。sumPrecise は今まで外部ライブラリで拾っていたケースを標準で潰してくれます。

# permission model と組み合わせて使う 27 専用フラグ
node --permission --allow-env=PATH -e "console.log('env read ok')"
# 実行結果: Node 27 → env read ok
# 実行結果: Node 26 → bad option: --allow-env(flag 自体が存在しない)

–allow-env は 26 に存在しないフラグなので、CI の実行マトリクスに並べる場合はバージョン分岐が必要です。

つまずきポイント

  • 「hasOwnProperty is not a function」が出たら req.headers の null プロトタイプ化が原因です。ミドルウェアやロガーのどこかで直接呼んでいるはずなので、依存を総当たりで grep しましょう
  • digest('utf8') はそもそも文字列を返しません。26 までの動作は未定義に近く、27 で正式に弾かれただけです
  • alpha を CI で回すなら matrix 分けが必要です。27 専用フラグは 26 では bad option で落ちます
  • serialize 形式は V8 のパッチ更新でも変わるようになりました。長期保存データはバージョン固定か、シリアライズしない設計を検討してください

検証環境

OS Windows 11 (build 10.0.26200)
CPU AMD Ryzen 9 PRO 8945HS w/ Radeon 780M Graphics
メモリ 28GB
言語/ツール Node.js v26.13.0 / v27.0.0-alpha.0.0.0 (公式 win-x64 ポータブル zip を一時ディレクトリに展開)
使用コマンド node -v / node case1~case5 (http・crypto・v8・新機能の各スクリプト) / node –permission –allow-env=PATH -e
測定日 2026-11-03

上記の環境で実際に実行して確認した結果です。環境が異なる場合は挙動が変わることがあります。

Node v26.13.0 と v27.0.0-alpha.0.0.0 で同じスクリプトを実行した実測ログ。req.headers の null プロトタイプ化による TypeError、crypto の ERR_UNKNOWN_ENCODING、Hmac 2 回目の DEP0206、keepAliveTimeout の 5000→65000、serialize 形式の変化、V8 15.6 新機能の有無、--allow-env の受理可否までを 1 枚にまとめたもの
Node v26.13.0 と v27.0.0-alpha.0.0.0 で同じスクリプトを実行した実測ログ。req.headers の null プロトタイプ化による TypeError、crypto の ERR_UNKNOWN_ENCODING、Hmac 2 回目の DEP0206、keepAliveTimeout の 5000→65000、serialize 形式の変化、V8 15.6 新機能の有無、–allow-env の受理可否までを 1 枚にまとめたもの

まとめ

箇所 Node 26 Node 27 対処
req.headers Object.prototype あり null プロトタイプ Object.hasOwn / in を使う
digest / update の encoding 無効値もそのまま通過 ERR_UNKNOWN_ENCODING hex / base64 を明示
Hmac.digest() の 2 回目 動く DEP0206 警告 createHmac を都度作り直す
keepAliveTimeout 既定値 5000ms 65000ms 必要なら明示
serialize 形式 0x0f 系 0x10 系(旧は読めない) 混在環境では要注意

直し自体は小さいですが、hasOwnProperty 潰しはミドルウェアを横断する作業になります。春の正式リリースまでに潰しておけば、乗り換えは楽ですよ。

参考

あわせて読みたい

この記事を書いた人: Kurosaki.Ren。記事のコードは隔離した環境で実行してから掲載しています。詳しいプロフィールは著者プロフィールページへどうぞ。

【広告】このサイトはConoHa WINGで運営しています。安定した高速サーバーで快適にブログを書けています。いつもありがとう!!

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

コメント

コメントする

CAPTCHA


目次