为何IIS 10中自定义处理程序未生效反而运行StaticFile处理程序

常见原因 #

• 处理程序映射优先级低于StaticFile处理程序：IIS处理程序匹配顺序为从上到下，若自定义的.uasp映射排序在StaticFile处理程序之后，请求会先被StaticFile捕获，直接返回静态文件处理错误，不会走到你配置的ASP处理程序。
• 处理程序请求限制配置错误：
  1. 动词设置未包含站点常用的请求方法（如GET、POST、HEAD）
  2. 「映射」选项卡中错误勾选了「仅当请求映射到以下内容时才调用处理程序」下的「文件或文件夹」，若存在虚拟路径的.uasp请求会匹配失败
  3. 「访问」选项卡未勾选「脚本」权限，导致ASP处理程序没有执行权限
• 处理程序使用的asp.dll路径与应用程序池架构不匹配：若应用程序池开启了「启用32位应用程序」选项，需使用C:\Windows\SysWOW64\inetsrv\asp.dll作为处理程序路径，64位应用程序池对应C:\Windows\System32\inetsrv\asp.dll，路径配置错误会导致处理程序加载失败，请求自动 fallback 到StaticFile。
• 站点级别配置被服务器级别的锁定规则覆盖：若服务器级别的处理程序映射配置了锁定，或者功能委派中「处理程序映射」设置为只读，站点级别的自定义配置不会生效。
• 未配置对应ISAPI执行权限：在「ISAPI和CGI限制」中，需要确认你使用的asp.dll对应的项状态为「允许」，否则自定义扩展名的处理程序会被拦截。

解决步骤 #

• 调整处理程序排序：进入站点的「处理程序映射」页面，点击右侧操作栏的「查看有序列表」，将你添加的.uasp映射移动到StaticFile处理程序之前，保存配置后重启站点。
• 检查请求限制配置：右键你添加的.uasp处理程序映射，选择「请求限制」，依次检查三个选项卡：
  1. 动词选项卡：选择「下列动词」，输入GET, HEAD, POST, DEBUG
  2. 映射选项卡：如果你的.uasp都是实际存在的文件，可以保留「文件」勾选，否则取消勾选
  3. 访问选项卡：选择「脚本」
• 核对应用程序池架构与asp.dll路径：进入应用程序池的「高级设置」查看「启用32位应用程序」配置，再核对处理程序映射中使用的dll路径是否对应。
• 检查功能委派与ISAPI限制：
  1. 回到IIS服务器根节点，打开「功能委派」，确认「处理程序映射」权限设置为「读取/写入」
  2. 打开服务器根节点的「ISAPI和CGI限制」，找到你使用的asp.dll对应的条目，确认状态为「允许」
• 验证配置：配置修改完成后执行iisreset命令重启IIS服务，再访问.uasp页面验证是否正常。

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