.NET MVC应用本地IIS测试正常 部署后访问返回空白页或404

核心诱因分析 #

• 正式环境IIS托管配置不匹配：本地IIS Express和服务器正式IIS的托管模式、模块注册逻辑不一致，比如服务器未安装对应版本的ASP.NET托管捆绑包、Startup中间件顺序配置错误，会直接导致路由匹配失效，接口抛404、视图渲染返回空白。
• IP校验逻辑环境适配错误：本地测试时取到的是本机内网IP，正式环境如果存在反向代理、负载均衡，直接取Request.UserHostAddress/HttpContext.Connection.RemoteIpAddress拿到的是代理服务器IP而非真实用户IP，会导致IP校验逻辑全部进入未授权分支，而未授权视图的路径、权限配置在正式环境渲染失败返回空白。
• 发布配置缺失：本地调试模式下视图是实时编译，发布时如果未开启视图预编译、发布包漏传了UserUnauthorized视图文件、KioskGuidance接口对应的路由配置，就会出现访问不到的情况。
• 授权中间件逻辑冲突：移除AllowAnonymous特性后如果全局授权过滤器已开启，未授权视图和接口的访问权限未单独放行，会导致请求被直接截断返回空白。

分步排查解决方法 #

1. 基础部署环境排查 #

• 确认正式服务器已安装和开发环境版本完全一致的.NET SDK/ASP.NET托管捆绑包，安装完成后重启IIS再测试。
• 打开IIS站点的「处理程序映射」面板，确认存在对应.NET版本的处理程序，不存在则重新安装托管包。

2. IP校验逻辑排查 #

• 在正式环境临时加日志输出，记录每次请求拿到的IP地址、IP网段比对结果，确认是否取到了真实用户IP。如果是反向代理环境，需要把ForwardedHeaders中间件放在所有中间件最前面，示例代码：

app.UseForwardedHeaders(new ForwardedHeadersOptions
{
    ForwardedHeaders = ForwardedHeaders.XForwardedFor | ForwardedHeaders.XForwardedProto
});

• 确认取到真实IP后再测试IP校验逻辑是否能正常进入跳转分支或未授权视图分支。

3. 404接口问题排查 #

• 确认Startup/Program.cs里的中间件顺序正确，正确顺序参考：异常处理→Https重定向→静态文件→路由→授权→端点映射，示例配置：

if (env.IsDevelopment())
{
    app.UseDeveloperExceptionPage();
}
else
{
    app.UseExceptionHandler("/Home/Error");
    app.UseHsts();
}
app.UseHttpsRedirection();
app.UseStaticFiles();
app.UseRouting();
app.UseAuthorization();
app.UseEndpoints(endpoints =>
{
    endpoints.MapControllerRoute(
        name: "default",
        pattern: "{controller=Home}/{action=Index}/{id?}");
});

• 检查KioskGuidance接口的路由特性是否和全局路由冲突，确认正式环境已开启特性路由支持。
• 开启IIS的「失败请求跟踪」，配置跟踪404状态码的请求，定位请求是被路由模块拦截还是授权模块拦截。

4. 空白页问题排查 #

• 先直接访问站点根目录的静态txt文件确认站点可正常响应，再直接访问未授权视图地址比如/Home/UserUnauthorized测试加载情况，打开浏览器F12查看响应状态码和控制台报错信息。
• 检查发布包的Views目录结构是否完整，UserUnauthorized.cshtml的构建动作是否设为「内容」，如果是「无」发布时不会打包进部署包。
• 如果是.NET Framework版本的MVC，检查Web.config里<customErrors>配置是否正确，错误页配置异常会导致触发异常时返回空白。

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