NET8 Blazor项目部署后渲染异常及资源加载403问题求助

问题详情 #

• 项目结构：包含服务器端项目、客户端项目及多个Blazor组件，使用已升级至.NET 8的ImageSelect组件，该组件需在App.razor中添加对应JavaScript代码
• 本地运行状态：渲染完全符合预期，开发工具无任何报错
• 部署后异常表现：
  • Windows/MacOS平台的Edge浏览器：网站渲染完全异常，开发者工具显示组件内嵌的CSS、JavaScript资源加载失败，返回403状态码
  • Safari浏览器：弹出未处理异常提示，要求在appSettings.Development.json中设置DetailedErrors: true以查看详情
• 已确认配置：主项目Program.cs已配置读取对应环境的appconfig.json，部署环境为Release，暂无法定位问题根源，已准备好无依赖的Blazor解决方案源码仓库

排查与解决方向 #

1. 静态资源权限与访问配置 #

• 检查部署服务器的静态文件目录权限，确保组件内嵌CSS/JS资源所在的wwwroot子目录允许匿名访问，避免服务器权限策略拦截请求导致403
• 确认Program.cs中已正确启用静态文件中间件：

  app.UseStaticFiles();
  

• 若组件资源为嵌入式资源，需在项目文件中确认嵌入配置正确：

  <EmbeddedResource Include="Components/**/*.css" />
  <EmbeddedResource Include="Components/**/*.js" />
  

2. 环境错误日志配置 #

• 尽管部署环境为Release，可临时在appSettings.Production.json中开启详细错误输出，获取更精准的异常信息：

  {
    "DetailedErrors": true,
    "Logging": {
      "LogLevel": {
        "Default": "Information",
        "Microsoft.AspNetCore": "Warning"
      }
    }
  }
  

  排查完成后记得关闭该配置，避免泄露敏感信息

3. 组件资源路径与兼容性检查 #

• 验证升级后的ImageSelect组件在.NET 8环境下的资源引用路径是否正确，确认组件内嵌资源的命名空间与项目命名空间匹配，避免路径解析错误
• 检查App.razor中添加的JavaScript代码是否在部署后正确加载，可通过开发者工具的Sources标签确认JS文件的存在性与路径正确性

4. 服务器部署环境配置 #

• 若使用IIS部署：检查站点身份验证设置，确保启用匿名身份验证；确认IIS应用程序池权限足够访问静态资源目录
• 若使用反向代理（如NGINX）：检查代理配置规则，确保静态资源请求未被拦截，且正确传递到Blazor应用

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