Web API实现Excel下载功能时接口链接出现站点无法访问问题

针对访问https://test.quality.com/rmqwebapis/GetReport/278时提示「该网页可能暂时无法正常访问，或已永久迁移至新的网页地址」的场景，按以下分层步骤定位解决：

托管层基础状态排查 #

• 先做最基础的连通性验证：访问站点的默认测试端点（比如WebAPI模板自带的无参数测试接口），如果连默认接口都报同样的错，说明根本不是下载接口本身的问题——要么WebAPI站点未正常启动、对应应用池崩溃，要么IIS的域名绑定、虚拟路径配置错误
• 核对虚拟路径的拼写匹配：接口路径里的rmqwebapis前缀，要和IIS中部署WebAPI的虚拟路径完全一致，很多人部署时把应用直接放在站点根目录，写代码时还保留着rmqwebapis的路由前缀，路径不匹配自然无法访问
• 检查应用程序池配置：比如.NET Core类WebAPI，对应的应用池必须配置为“无托管代码”模式，如果错选经典.NET Framework托管模式，进程根本无法启动，自然所有接口都会出现访问异常

路由规则匹配校验 #

• 核对接口路由配置：确认GetReport/{id}接口的路由设置，是否完整匹配rmqwebapis/GetReport/278的完整路径，有没有出现控制器级路由前缀和全局路由重复、漏写路由特性导致的匹配失败
• 核对请求方法匹配：如果下载接口当初只标记了POST请求特性，现在通过浏览器地址栏直接访问时，默认发送的是GET请求，方法不匹配场景下，很多IIS默认配置不会返回标准405错误，反而会弹出“网页无法访问、已永久迁移”的提示
• 检查路由参数约束：如果接口写了{id:int}这类参数约束，传入的参数格式不符合要求时，路由会直接匹配失败，不会进入接口的业务逻辑

中间层规则干扰排查 #

• 检查URL重写规则配置：很多站点会配置HTTP强制跳HTTPS、旧路径迁移等重写规则，如果规则的匹配范围设置过宽，把所有接口请求都判定为待迁移的旧页面做重定向，就会触发永久访问的提示
• 验证前置网关/代理的转发规则：如果域名前置了Nginx、API网关这类中间层，要确认/rmqwebapis/开头的请求是否被正确转发到后端WebAPI服务，有没有出现转发时截断路径、转发目标错误的情况

快速定位的实用技巧 #

• 直接登录WebAPI所在服务器，通过localhost加站点实际端口访问目标接口，如果本机访问完全正常，问题100%出在域名解析、IIS绑定、代理转发层，和WebAPI业务代码无关
• 关闭IIS和浏览器的“显示友好HTTP错误信息”设置，直接查看底层错误的具体状态码：比如404.0代表路由根本没匹配到，404.3代表MIME类型被拦截，500.21代表应用池配置和运行时不兼容，根据状态码定位问题远比盲目猜测高效
• 针对Excel文件下载场景，要确认IIS是否注册了Excel文件对应的MIME类型，未注册对应类型时，服务器会直接拦截下载请求触发访问异常

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