Delphi7遗留ISAPI应用（基于TWebModule）在新版IIS中PathInfo异常

我之前帮朋友处理过一模一样的Delphi 7 ISAPI在新版IIS（比如IIS 10）上的PathInfo适配问题，踩了不少坑，整理几个实用的解决办法给你：

一、先搞懂问题根源 #

从IIS 7.0开始，微软对ISAPI扩展的请求处理逻辑做了关键调整——尤其是URL解析和管道模式的变化。Delphi 7的TWebRequest.PathInfo是基于旧版IIS的规范开发的，完全没适配这种新逻辑，才会出现路径不符合预期的情况。

二、快速修复的两种路径 #

1. 手动从服务器变量提取正确路径 #

新版IIS会把原始请求的完整路径存在UNENCODED_URL或者HTTP_X_ORIGINAL_URL这两个服务器变量里，你可以在BeforeDispatch事件里手动读取并替换PathInfo：

procedure TWebModule1.WebModuleBeforeDispatch(Sender: TObject;
  Request: TWebRequest; Response: TWebResponse; var Handled: Boolean);
var
  OriginalURL: string;
  VirtualDir: string;
begin
  // 优先取UNENCODED_URL，这个是IIS 7+原生提供的未编码原始路径
  OriginalURL := Request.ServerVariables['UNENCODED_URL'];
  if OriginalURL = '' then
    OriginalURL := Request.ServerVariables['HTTP_X_ORIGINAL_URL'];
  
  if OriginalURL <> '' then
  begin
    // 替换成你的ISAPI应用对应的虚拟目录，比如'/MyLegacyAPI'
    VirtualDir := '/MyLegacyAPI/';
    // 截取虚拟目录之后的部分作为正确的PathInfo
    if Pos(VirtualDir, OriginalURL) > 0 then
      Request.PathInfo := Copy(OriginalURL, Pos(VirtualDir, OriginalURL) + Length(VirtualDir), MaxInt)
    else
      // 如果是根目录部署，直接用整个OriginalURL
      Request.PathInfo := OriginalURL;
  end;

  // 继续你的日志记录逻辑
end;

提示：一定要根据你的应用实际部署的虚拟目录调整VirtualDir的值，不然截取会出错。

2. 切换IIS应用池到经典模式 #

新版IIS默认用集成管道模式，而Delphi 7的ISAPI是为旧版的经典模式设计的。切换模式的步骤很简单：

• 打开IIS管理器，找到你的ISAPI应用对应的应用池
• 右键选择「高级设置」
• 把「托管管道模式」从「集成」改成「经典」
• 重启应用池和网站

这个方法零代码改动，但如果你的服务器上还有其他依赖集成模式的应用，可能会有冲突，需要根据实际情况权衡。

三、调试和验证技巧 #

• 在BeforeDispatch里把所有和路径相关的服务器变量都打日志：比如PATH_INFO、UNENCODED_URL、HTTP_X_ORIGINAL_URL、SCRIPT_NAME，对比新旧IIS的输出差异，能快速定位问题点
• 用抓包工具（比如Fiddler）查看客户端实际发送的URL和IIS传递给ISAPI的路径是否一致，帮你排查是请求端还是服务器端的问题

四、长期维护建议 #

如果这个遗留应用还有后续维护计划，建议考虑升级到较新的Delphi版本（比如Delphi 10.4及以上）。新版本的TWebModule已经完全适配了新版IIS的ISAPI处理逻辑，从根源上避免这类兼容问题，后续维护也会省心很多。

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