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 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 潰しはミドルウェアを横断する作業になります。春の正式リリースまでに潰しておけば、乗り換えは楽ですよ。
参考
- Node.js v27.0.0-alpha.0.0.0 リリースノート(公式)
- Evolving the Node.js Release Schedule(公式アナウンス)
- http: make req.headers have a null prototype #62900
- crypto: validate digest output encodings #66247
- crypto: runtime-deprecate calling Hmac.digest() more than once #63624
あわせて読みたい
- 【JS・フロントエンド】Node.js 26の新機能まとめ — TemporalやIterator.concatを今すぐ使う
- 【JS・フロントエンド】Node.js 26.10のutil.debounceでlodashを削る — leading・キャンセル・Promiseの実測
- 【JS・フロントエンド】ERR_UNSUPPORTED_TYPESCRIPT_SYNTAXの直し方 — 型ストリッピング非対応構文の移行ログ
この記事を書いた人: Kurosaki.Ren。記事のコードは隔離した環境で実行してから掲載しています。詳しいプロフィールは著者プロフィールページへどうぞ。
【広告】このサイトはConoHa WINGで運営しています。安定した高速サーバーで快適にブログを書けています。いつもありがとう!!![]()

コメント