Selenium子域名场景下InvalidCookieDomainException异常问题排查

异常原因 #

Selenium添加Cookie时严格遵循浏览器的Cookie同源规则：

1. 当你创建Cookie对象时如果不指定Domain属性，Selenium会默认使用当前页面的完整域名（比如test.example.com）作为Cookie的Domain。但部分网站的服务器端Cookie策略要求Domain必须是顶级域名的后缀格式（如.example.com），或者目标子域名的页面在响应中设置了更严格的Cookie域规则，导致你添加的Cookie域名不匹配，触发InvalidCookieDomainException。
2. 少数情况下，如果test.example.com页面加载未完成就尝试添加Cookie，也可能引发域名校验失败，但你的代码里先执行了Navigate().GoToUrl，所以这种概率极低。

解决办法 #

核心是显式指定Cookie的Domain属性，匹配目标网站允许的Cookie域规则，以下是两种可行方案：

方案1：指定顶级域名后缀（适配所有子域名） #

如果需要Cookie在www.example.com、test.example.com等所有子域名下生效，直接将Domain设为.example.com（注意前面的点）：

private static void IsNotWorkingFixed()
{
    IWebDriver driver = new ChromeDriver();
    try {
        driver.Navigate().GoToUrl("https://test.example.com");
        // 显式指定Domain为顶级域名前缀，同时设置路径和过期时间（可选但推荐）
        var cookie = new Cookie(
            "key", 
            "value", 
            ".example.com",  // 关键：带点的顶级域名后缀
            "/", 
            DateTime.Now.AddDays(1)
        );
        driver.Manage().Cookies.AddCookie(cookie);
    } finally {
        driver.Quit();
    }
}

方案2：指定当前子域名精确匹配 #

如果只需要Cookie在test.example.com下生效，直接将Domain设为当前页面的完整域名：

private static void IsNotWorkingFixed()
{
    IWebDriver driver = new ChromeDriver();
    try {
        driver.Navigate().GoToUrl("https://test.example.com");
        var cookie = new Cookie(
            "key", 
            "value", 
            "test.example.com",  // 精确匹配当前子域名
            "/", 
            DateTime.Now.AddDays(1)
        );
        driver.Manage().Cookies.AddCookie(cookie);
    } finally {
        driver.Quit();
    }
}

额外注意事项 #

• 浏览器Cookie规则细节：带点的Domain（.example.com）表示Cookie适用于所有子域名，不带点的Domain则仅适用于当前精确域名，部分老版本浏览器可能对不带点的Domain处理有差异，推荐显式指定。
• 确保页面加载完成：如果页面加载慢，建议添加页面就绪等待，避免在DOM未完全加载时操作Cookie：

  new WebDriverWait(driver, TimeSpan.FromSeconds(10))
      .Until(d => ((IJavaScriptExecutor)d).ExecuteScript("return document.readyState").Equals("complete"));
  

• 匹配网站实际Cookie策略：可以通过浏览器开发者工具（Application -> Cookies）查看目标网站已有的Cookie的Domain格式，确保你添加的Cookie Domain和网站原生Cookie一致。

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