Azure Static Web Apps 有兩種十分注重執行階段和語言版本的位置，分別在前端和 API。
| 執行階段類型 | 說明 |
|---|---|
| 前端 | 負責執行建置前端應用程式的網站建置步驟的版本。 |
| 應用程式介面 | Web 應用程式中所使用的 Azure Functions 版本和運行時間。 |
前端
您可以指定用來建置靜態 Web 應用程式前端的版本。 只有在您需要以較舊版本為目標時，才需要設定非預設版本。
您可以在檔案區段中的 package.json 檔案 engines 中，指定建置靜態 Web 應用程式的前端的運行時間版本。
{
...
"engines": {
"node": ">=14.0.0"
}
}
API
Azure Static Web Apps 中 API 的基礎支援是由 Azure Functions 提供。 如需詳細資訊，請參閱 Azure Functions 支援的語言和運行時間 。
靜態 Web Apps 中受管理的函式支援以下版本。 如果您的應用程式需要未列出的版本，請考慮 將您自己的函式帶入 您的應用程式。
若要設定 API 語言執行階段版本，請將 apiRuntime 區段中的 platform 屬性設定為下列其中一個支援的值。
| 語言執行平台版本 | 操作系統 | Azure Functions 版本 |
apiRuntime 值 |
支援結束日期 |
|---|---|---|---|---|
| .NET Core 3.1 | 窗戶 | 3.x | dotnet:3.1 |
2022 年 12 月 3 日 |
| .NET 6.0 同處理序 | 窗戶 | 4.x | dotnet:6.0 |
2025年4月30日 |
| .NET 8.0 同處理序 | 窗戶 | 4.x | dotnet:8.0 |
2026 年 11 月 10 日 |
| .NET 6.0 隔離式 | 窗戶 | 4.x | dotnet-isolated:6.0 |
2025年4月30日 |
| .NET 7.0 隔離式 | 窗戶 | 4.x | dotnet-isolated:7.0 |
2025年4月30日 |
| .NET 8.0 隔離式 | 窗戶 | 4.x | dotnet-isolated:8.0 |
2026 年 11 月 10 日 |
| .NET 9.0 隔離式 | 窗戶 | 4.x | dotnet-isolated:9.0 |
2026 年 11 月 10 日 |
| .NET 10.0 獨立版 | 窗戶 | 4.x | dotnet-isolated:10.0 |
- |
| Node.js 12.x | Linux | 3.x | node:12 |
2022 年 12 月 3 日 |
| Node.js 14.x | Linux | 4.x | node:14 |
2025年4月30日 |
| Node.js 16.x | Linux | 4.x | node:16 |
2025年4月30日 |
| Node.js 18.x | Linux | 4.x | node:18 |
2025 年 5 月 31 日 |
| Node.js 20.x | Linux | 4.x | node:20 |
- |
| Node.js 22.x | Linux | 4.x | node:22 |
- |
| Python 3.8 | Linux | 4.x | python:3.8 |
2025年4月30日 |
| 蟒蛇3.9 | Linux | 4.x | python:3.9 |
- |
| Python 3.10 版本 | Linux | 4.x | python:3.10 |
- |
| Python 3.11 | Linux | 4.x | python:3.11 |
- |
.NET
若要變更 .NET 應用程式中的執行階段版本，請變更 csproj 檔案中的 TargetFramework 值，並將 apiRuntime 檔案中的 值設為相符的版本。 確保 apiRuntime 數值與你在 csproj 檔案中定義的一致。
.NET 10.0 僅支援隔離式背景工作程序模型。 如果你的 API 使用程序內模型，請先 遷移到隔離工作者模型。 關於針對 .NET 10.0 所需的套件與專案設定，請參閱在孤立工作者模型中執行 C# Azure Functions 的指南。
以下範例示範如何在 TargetFramework 檔案中更新 元素，將 .NET 10.0 設定為 API 語言執行階段版本。
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
<TargetFramework>net10.0</TargetFramework>
...
</PropertyGroup>
...
以下範例配置示範如何利用 apiRuntime 屬性，在 staticwebapp.config.json 檔案中選取 .NET 10.0 isolated 作為 API 語言執行階段版本。
{
...
"platform": {
"apiRuntime": "dotnet-isolated:10.0"
}
...
}
Node.js
下列範例組態示範如何使用 apiRuntime 屬性來選取 Node.js 20 作為 staticwebapp.config.json 檔案中的 API 語言執行平臺版本。
{
...
"platform": {
"apiRuntime": "node:20"
}
...
}
Python
下列範例組態示範如何使用 apiRuntime 屬性，將 Python 3.11 選取為 staticwebapp.config.json 檔案中的 API 語言執行平臺版本。
{
...
"platform": {
"apiRuntime": "python:3.11"
}
...
}
在 v4.x 中重新啟用 Proxy
Azure Functions 支援在 v4.x 中重新啟用代理。 若要在靜態 Web 應用程式的 Managed 函式中啟用 Proxy 支援，請在應用程式設定中設定為 SWA_ENABLE_PROXIES_MANAGED_FUNCTIONStrue 。
備註
雖然 v4.x 支援 Proxy，但請考慮使用 Azure API 管理與受控函式應用程式整合，因此您的應用程式不依賴 Proxy。
取代
備註
現在 Azure Functions v3 已淘汰，Static Web Apps 會使用 Azure Functions v4 來支援 Python 3.8 的 API 運行時間。 重新部署您的應用程式以啟用這項變更。 雖然不建議，但您可以將環境變數USEV3_FOR_PYTHON38true設定為 ，以還原回 v3。
Azure Static Web Apps 中已淘汰下列運行時間。 如需變更運行時間的詳細資訊，請參閱 在 Azure Static Web Apps 中指定 API 語言執行平臺版本 ，並將 應用程式從 Azure Functions 3.x 版移轉至 4.x 版。
- .NET Core 3.1
- Node.js 12.x