App Service / Azure Functions の Windows 環境において `Node.js 24` を利用する場合は 64 bit process の有効化を行ってください。

Published: feedback 共有

お世話になっております。Azure App Service サポート担当の押田です。
本記事では、App Service / Azure Functions の Windows 環境において、 Node.js 24 を利用する際の注意点を記載します。
結論から先にお伝えしますと、プラットフォームの設定 にて 64bit プロセスの有効化をしていただく必要がございます。

Windows 環境で Node.js 24 を利用する方法

App Service / Azure Functions の Windows 環境においては、Azure ポータルから Node.js 24 が選択可能な状態となっています。

image-d6ac67a5-c68b-4528-afb7-bc663ce85014.png

ここで選択した Node.js バージョンは、App Settings WEBSITE_NODE_DEFAULT_VERSION~24 を指定する動作となります。
App Service では WEBSITE_NODE_DEFAULT_VERSION に指定された値に応じて、プラットフォーム側があらかじめ配置したバイナリに対してパスが通るような仕組みとなっています。
ただし、32 bit プロセス用(C:\Program Files (x86)\nodejs 配下) には 24 系のバイナリファイルが用意されていません。24 系のバイナリは 64 bit プロセス用(C:\Program Files\nodejs 配下) のみに提供されているものとなります。

64 bit プロセスを有効にする

ポータルから操作する

App Service / Azure Functions いずれもポータルでは [構成] メニューから変更可能です。

image-113ac236-99be-41fa-94ae-9be9478b0e67.png

Az CLI から操作する

az webapp config set

1
2
3
4
az webapp config set \
  --resource-group <RG名> \
  --name <WebApp名> \
  --use-32bit-worker-process false

あるいは az functionapp config set を利用します。

1
2
3
4
az functionapp config set \
  --resource-group <RG名> \
  --name <WebApp名> \
  --use-32bit-worker-process false

Node 24 が利用されていることを確認する

Kudu Process Explorer から node プロセスの情報を確認することができます。

image-ad6881ba-231f-4969-ac15-9dea34bb221a.png

32 bit プロセスを指定した場合のエラー例

App Service の場合

IIS Node で実行する Node プロセスが見つからないため、500 エラーとなります。
下記ドキュメント [node アプリケーションが起動しない] シナリオに該当します。

Azure Functions の場合

Node Language Worker プロセスを起動できないため、Functions Host が正常起動しません。

[概要] に下記のように表示されます。

image-ac42b9df-47ed-44b6-b146-8dd4c3acf5aa.png

また、exceptions テーブルには、RecordAndThrowExternalStartupException として、node exited with code 1 (0x1) といった情報が確認できます。

image-23cd3aef-a60e-48fa-aef4-5594aa08bf47.png

参考ドキュメント



2026 年 03 月 03 日時点の内容となります。
本記事の内容は予告なく変更される場合がございますので予めご了承ください。

※本情報の内容(添付文書、リンク先などを含む)は、作成日時点でのものであり、予告なく変更される場合があります。