.NET 6 Blazor Server新增页面后部署异常求助

一、Foyer独立CSS文件失效排查 #

• 检查CSS发布完整性：确认foyer.css是否被包含在发布包中，在服务器站点根目录的对应静态资源文件夹（如wwwroot/css）中查看文件是否存在。本地调试时文件默认在wwwroot，若发布时未设置“复制到输出目录”为“始终复制”，会导致文件遗漏。
• 验证引用路径正确性：检查页面或组件中CSS的引用代码，确保使用相对路径（如<link href="~/css/foyer.css" rel="stylesheet" />），避免绝对路径引发的404错误。可通过Chrome开发者工具Network标签查看该文件的请求状态，若为404则路径或文件存在问题。
• 确认静态文件中间件配置：在Program.cs中必须存在app.UseStaticFiles();代码，发布模式下若遗漏或注释该行，会导致所有静态资源无法访问。
• 排查文件压缩问题：若发布时开启了静态文件压缩，可尝试关闭该选项后重新发布，排查是否因压缩过程导致CSS文件内容损坏。

二、登录后主页面无内容（授权相关）排查 #

• 检查路由与授权属性：确认主页面组件的@page指令无路由冲突，[Authorize]属性配置正确。新增页面若占用了主页面路由，会导致主页面无法被匹配渲染。
• 验证身份验证凭证：登录后在Chrome开发者工具Application标签下，查看AspNetCore.Identity.Application Cookie是否存在、有效期是否正常。若Cookie缺失，需检查生产环境下的Cookie SameSite、HTTPS配置是否与开发环境一致。
• 查看服务器授权日志：在服务器应用日志（Windows事件查看器、Linux syslog或站点日志文件）中搜索“Authorization failed”关键词，定位具体的权限不足或策略不匹配问题。
• 核对生产环境配置：对比appsettings.Production.json与appsettings.Development.json的身份验证配置，确认是否存在RequireConfirmedAccount开启但生产用户未验证、数据库连接字符串错误导致权限读取失败等情况。
• 检查组件条件渲染逻辑：主页面若有@if (context.User.Identity.IsAuthenticated)这类条件渲染代码，可添加日志输出（如Console.WriteLine(context.User.Identity.IsAuthenticated);），通过服务器日志确认身份判断是否正确执行。

三、本地正常、发布异常的共性排查 #

• 清理发布缓存：本地发布时勾选“删除目标中的所有现有文件”，服务器端手动清空站点目录后重新上传发布包，避免新旧文件冲突。
• 核对发布配置：检查Visual Studio发布配置中的目标框架是否正确，是否开启了可能影响功能的特殊选项（如“裁剪未使用的代码”），可尝试用默认配置重新发布测试。
• 确认环境变量设置：服务器上ASPNETCORE_ENVIRONMENT需设置为Production，避免因环境变量不匹配导致配置加载错误。

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