ABP 7.0 Blazor发布至IIS后自定义页面404错误求助

1. 必须初始化OpenIddict基础数据 #

ABP.IO的OpenIddict模块依赖客户端、授权范围这类基础配置数据，空表会直接导致验证逻辑异常，进而触发路由拦截或跳转错误页，这是核心问题。

2. 初始化OpenIddict数据的具体操作 #

• 先确认项目已启用ABP的OpenIddict模块（模板创建的项目一般默认包含）
• 执行数据库迁移：在项目DbContext层面，ABP已自动集成OpenIddict的实体配置，发布前要运行Update-Database（EF Core）或对应迁移命令，把OpenIddict的表结构和基础数据同步到生产库
• 若迁移未自动生成必要数据，手动添加：
  • 客户端（Client）：添加对应Blazor应用的配置，设置允许的授权类型（比如authorization_code、refresh_token）、重定向URI（必须匹配生产环境Blazor地址，例如https://你的域名/authentication/login-callback）、允许的范围（openid、profile、email加上你的API范围）
  • 范围（Scope）：添加应用所需的标准OpenID范围和自定义API范围
  • 应用关联：把客户端和范围绑定，确保权限配置匹配业务需求

3. IIS部署的路由与验证配置检查 #

• 配置IIS URL重写规则：Blazor应用需要把所有非文件/目录请求重写到index.html，否则自定义页面会404。在项目web.config里加以下规则：

<rewrite>
  <rules>
    <rule name="Blazor Routes" stopProcessing="true">
      <match url=".*" />
      <conditions logicalGrouping="MatchAll">
        <add input="{REQUEST_FILENAME}" matchType="IsFile" negate="true" />
        <add input="{REQUEST_FILENAME}" matchType="IsDirectory" negate="true" />
      </conditions>
      <action type="Rewrite" url="index.html" />
    </rule>
  </rules>
</rewrite>

• 确认app.UseAbpOpenIddictValidation();的位置：在Program.cs里，这个中间件要放在app.UseRouting();之后、app.UseAuthorization();之前，顺序错了会导致验证逻辑混乱
• 核对生产环境配置文件（appsettings.Production.json）：
  • OpenIddict的Authority地址要指向服务器域名，不能用localhost
  • 客户端的ClientId、ClientSecret要和数据库里的配置完全一致
  • CORS配置要允许生产环境Blazor应用的域名访问API

4. 日志排查细节 #

• 开启OpenIddict详细日志：在appsettings.Production.json里加以下配置，查看具体验证失败原因：

"Logging": {
  "LogLevel": {
    "OpenIddict": "Debug",
    "OpenIddict.Server": "Debug",
    "OpenIddict.Validation": "Debug"
  }
}

• 检查IIS站点日志和应用程序日志，定位404请求的具体路径和触发的中间件环节

5. 其他注意事项 #

• 确保IIS应用程序池的.NET版本和项目目标框架匹配
• 检查服务器防火墙，保证HTTPS端口（通常443）可正常访问
• 不要随意移除app.UseAbpOpenIddictValidation();，这个中间件负责API身份验证，移除后会导致权限校验失效，反而引发更多问题

内容的提问来源于stack exchange，提问作者Lagamort