Azure Functions(V4) をVScodeでデプロイすると「Error building configuration in an external startup class.」と表示される。

嶋紘誠 0 評価のポイント
2025-12-23T09:48:12.1066667+00:00

質問内容

Azure Functions の起動時に、以下のエラーでホスト初期化が失敗します。 メッセージから Microsoft.Azure.WebJobs.Extensions.Storage の最小要件未満 もしくは 互換性不一致 が疑われます。正しいバージョン組み合わせと解消手順についてご教示ください。

エラー（抜粋）

Error building configuration in an external startup class. Microsoft.Azure.WebJobs.Script.ExternalStartupException : Error building configuration in an external startup class. ---> Microsoft.Azure.WebJobs.Script.HostInitializationException : One or more loaded extensions do not meet the minimum requirements. For more information see https://aka.ms/func-min-extension-versions. ExtensionStartupType AzureStorageWebJobsStartup from assembly 'Microsoft.Azure.WebJobs.Extensions.Storage, Version=3.0.3.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35' does not meet the required minimum version of 4.0.4.0. Update your NuGet package reference for Microsoft.Azure.WebJobs.Extensions.Storage to 4.0.4 or later. ...

環境情報（現在の構成）

FUNCTIONS_EXTENSION_VERSION：~4（Azure Functions v4）

*.csproj の抜粋（現状）

<Project Sdk="Microsoft.NET.Sdk"> <PropertyGroup> <TargetFramework>netstandard2.0</TargetFramework> <WarningsAsErrors></WarningsAsErrors> <DefaultItemExcludes>**</DefaultItemExcludes> </PropertyGroup> <ItemGroup> <PackageReference Include="Microsoft.Azure.WebJobs.Extensions.Storage" Version="5.0.0" /> <PackageReference Include="Microsoft.Azure.WebJobs.Script.ExtensionsMetadataGenerator" Version="1.1.0" /> </ItemGroup> </Project>

補足：

*.csproは Microsoft.Azure.WebJobs.Extensions.Storage を5.0.0 で指定していますが、 4.0.4 以上が必要というメッセージが出ています。

WEBSITE_RUN_FROM_PACKAGE=0

<モデレーター注>
以下のスレッドでの質問と重複であるためロックしました。
このスレッドの質問については、以下のスレッドで継続してください。
スレッド： Azure Functions(V4) をVScodeでデプロイすると「Error building configuration in an external startup class.」と表示される。

Azure Functions
Azure Functions

イベントドリブンのサーバーレス コンピューティング プラットフォームを提供する Azure サービス。

ロックされた質問。 役に立つかどうかに投票することはできますが、コメントの追加、質問への返信やフォローはできません。

0 件のコメント

1 件の回答

並べ替え方法: 最も役に立つ
最も役に立つ 新しい順 古い順
  1. Siddhesh Desai 8,210 評価のポイント Microsoft 外部スタッフ モデレーター
    2025-12-24T07:26:25.7166667+00:00

    こんにちは @嶋紘誠

    Microsoft Q&A にお問い合わせいただきありがとうございます。

    この問題を解決するには、以下の手順に従ってください。

    このエラーは通常、使用している Microsoft.Azure.WebJobs.Extensions.Storage パッケージのバージョンが、Azure Functions v4 で必要なバージョンと互換性がないことを示しています。

    解決のための推奨手順：

    NuGet パッケージの更新：エラーメッセージには、AzureStorageWebJobsStartup が Microsoft.Azure.WebJobs.Extensions.Storage バージョン 4.0.4 以降を必要とすることが示されています。現在プロジェクトではバージョン 5.0.0 が指定されており、これは要件を満たしているはずですが、NuGet パッケージマネージャーを使用して更新するか、互換性を確認することをお勧めします。

    dotnet add package Microsoft.Azure.WebJobs.Extensions.Storage --version 5.0.0

    既に正しく設定している場合は、パッケージを再インストールしてすべてが最新の状態になっていることを確認してみてください。

    スタートアップクラスの確認：ホストと関数が、以前のバージョンで非推奨または互換性のないスタートアップクラスを使用していないことを確認してください。関数アプリのスタートアップ構成を確認できます。

    ローカルでの実行：デプロイする前に、最新のAzure Functions Core Toolsを使用して関数がローカルで正しく動作することを確認してください。これにより、クラウドデプロイ時に発生する可能性のある問題を、ローカル環境で事前に特定できます。

    構成設定：AzureでFUNCTIONS_EXTENSION_VERSION設定が~4に設定されていること、およびAzureポータルの関数アプリ設定に必要な構成が反映されていることを確認してください。

    Application Insightsの使用：Application Insightsを有効にして、スタートアップエラーを詳細に捕捉してください。これにより、根本的な問題がある場合に、より多くのコンテキスト情報が得られます。

    Azure Function Appキャッシュのクリア：以前のバージョンのキャッシュが残っていると、競合が発生する場合があります。Azure Functionアプリを停止し、以前のデプロイをすべて削除してから再デプロイしてみてください。

    以下のリンクを参照してください。

    https://docs.microsoft.com/nuget/consume-packages/upgrade-packages

    この回答は役に立ちましたか?

    0 件のコメント