解决URL附加?AspxAutoDetectCookieSupport=1导致Stripe WebHook失效问题

问题原因 #

AspxAutoDetectCookieSupport=1是ASP.NET内置的Cookie支持自动检测机制，当框架无法确定客户端是否支持Cookie时，会自动附加该参数并触发重定向验证。你之前在web.config中设置的cookieless='UseCookies'仅对ASP.NET页面（.aspx）生效，因为该配置默认绑定到处理aspx的PageHandlerFactory；而.ashx一般处理程序由SimpleHandlerFactory处理，并未自动继承该配置，所以仍会触发检测逻辑，导致参数被附加到WebHook地址中，触发Stripe的重定向判定。

解决方案 #

1. 全局强制禁用Cookie自动检测 #

在web.config的<system.web>节点下添加或修改以下配置，覆盖所有HTTP处理程序的Cookie检测行为：

<system.web>
  <!-- 全局设置Cookie模式为仅使用Cookie，禁用自动检测 -->
  <httpRuntime cookieless="UseCookies" />
  <!-- 确保页面配置也同步 -->
  <pages cookieless="UseCookies" />
</system.web>

如果是IIS7及以上版本，还需要在<system.webServer>节点中确保处理程序配置正确：

<system.webServer>
  <handlers>
    <add name="SimpleHandlerFactory-Integrated" 
         path="*.ashx" 
         verb="*" 
         type="System.Web.UI.SimpleHandlerFactory" 
         preCondition="integratedMode" />
  </handlers>
</system.webServer>

2. 针对单个ASHX文件单独配置 #

如果不想全局修改，可以通过<location>节点为你的WebHook处理程序单独设置：

<location path="YourStripeWebHook.ashx">
  <system.web>
    <httpRuntime cookieless="UseCookies" />
    <pages cookieless="UseCookies" />
  </system.web>
</location>

将YourStripeWebHook.ashx替换为你实际的WebHook处理程序文件名。

3. 在ASHX代码中直接处理 #

如果上述配置仍不生效，可以在ASHX的ProcessRequest方法中手动移除参数或禁用检测，避免重定向：

public void ProcessRequest(HttpContext context)
{
    // 移除AspxAutoDetectCookieSupport参数，重写路径但不发送重定向响应
    if (context.Request.QueryString["AspxAutoDetectCookieSupport"] != null)
    {
        context.RewritePath(context.Request.Path);
    }

    // 此处添加你的Stripe WebHook逻辑
    context.Response.ContentType = "application/json";
    // ... 处理Stripe事件代码
}

这种方式直接在请求到达时修正路径，不会触发重定向，符合Stripe WebHook的要求。

4. 验证Session配置 #

如果你的应用使用了Session，确保Session的Cookie模式也设置为UseCookies：

<system.web>
  <sessionState cookieless="UseCookies" mode="InProc" />
</system.web>

Session的Cookie配置也会影响ASP.NET的自动检测逻辑。

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