abp 10.0 FileNotFoundException: Could not load IdentityModel v5.2.0 in HealthCheck collector (affects both ApiHost and Web projects) #10144

6 Answer(s)

• 

  0

  AI-Bot created yesterday

  Support Team ABP Agent

  1. Solution

  • Root cause: HealthChecks.UI (Xabaril) internally uses IdentityModel for some scenarios (e.g., OAuth2 discovery, client credentials). In certain dependency graphs, IdentityModel isn’t copied to the output when it’s only a transitive dependency. Then the HealthChecks UI background collector fails with “Could not load file or assembly 'IdentityModel, Version=5.2.0.0'”.

  • Quick fix (per project failing at runtime, e.g., *.Web and *.ApiHost):

    1. Add an explicit package reference to IdentityModel 5.2.0 (the version your error requests):

  <ItemGroup>
      <PackageReference Include="IdentityModel" Version="5.2.0" />
    </ItemGroup>
  

  2. Clean and rebuild the solution.

  • Microservice template HealthChecks configuration check:
    • In your HealthChecksBuilderExtensions (or equivalent), ensure the UI is configured normally; nothing extra is required beyond adding the package when the assembly resolution problem occurs. Example pattern:

  services
        .AddHealthChecks()
        .AddCheck<MyProjectNameDatabaseCheck>("Database");
  
    services.AddHealthChecksUI(settings =>
    {
        settings.AddHealthCheckEndpoint("Self", "/health-status"); // or your configured URL
    })
    .AddInMemoryStorage();
  

  • If you are running containerized/k8s and want to use machine name, you may set:

  settings.AddHealthCheckEndpoint("Self", $"http://{System.Net.Dns.GetHostName()}/health-status");
  

  Otherwise keep using the configured healthCheckUrl string.

  • Why this is safe: The IdentityModel package is a pure client library (no side effects if unused at runtime) and matches the HealthChecks UI’s transitive expectation. Adding it explicitly pins the assembly and avoids loader failures.

  • Optional: Align HealthChecks packages

    • Ensure the Xabaril packages you use (AspNetCore.HealthChecks.UI, AspNetCore.HealthChecks.UI.Client, etc.) are on compatible versions across your services. If you see similar loader issues with other assemblies, update these packages consistently so their transitive dependencies match.

  2. Sources

  • ABP Microservice Health Check Configuration:
    • https://abp.io/docs/latest/solution-templates/microservice/health-check-configuration
    • https://abp.io/docs/10.0//solution-templates/microservice/health-check-configuration
  • Xabaril HealthChecks (HealthChecks.UI):
    • https://github.com/Xabaril/AspNetCore.Diagnostics.HealthChecks
  • IdentityModel 5.2.0 package:
    • https://www.nuget.org/packages/IdentityModel/5.2.0
  • ABP Module System (general reference):
    • https://abp.io/docs/latest/framework/architecture/modularity/basics

  ---

  This response was generated by AI. If it didn’t solve your problem, feel free to post a new answer — our support team will jump in to help you soon.

  Save Cancel
• 

  0

  maliming created yesterday

  Support Team Fullstack Developer

  hi

  You can try to add <PackageReference Include="IdentityModel" Version="7.0.0" /> after KubernetesClient.

  We will update Studio templates in version 2.0.2

  Thanks.

  Save Cancel
• 

  0

  829098@qq.com created yesterday

  这个可以。但是api站点会出现 Unable to render this definition The provided definition does not specify a valid version field.

  Please indicate a valid Swagger or OpenAPI version field. Supported version fields are swagger: "2.0" and those that match openapi: 3.x.y (for example, openapi: 3.1.0).

  Save Cancel
• 

  0

  maliming created yesterday

  Support Team Fullstack Developer

  错误的的日志和截图是?

  Save Cancel
• 

  0

  829098@qq.com created yesterday

  可能是服务器环境的问题，客户端访问正常。

  Save Cancel
• 

  0

  maliming created yesterday

  Support Team Fullstack Developer

  好的

  Save Cancel