使用CefSharp.OffScreen并发执行异步JS出现Task Canceled错误如何解决

任务取消的根本原因 #

你遇到的Task Canceled异常本质是EvaluateScriptAsync调用超时触发了内部取消令牌抛出的异常，并非任务被主动终止。
CefSharp 89.x版本默认所有ChromiumWebBrowser实例共享同一个渲染进程，所有JS执行逻辑都跑在该进程的唯一V8主线程上，多实例同时调用JS时会进入串行排队队列。你设置的1000ms超时时间过短，排队的任务还没轮到执行就触发了超时取消，所以会出现只有1个实例能执行成功、其余全部报错的现象。

操作误区 #

1. 未配置Cef全局进程策略，默认的共享渲染进程模式不支持多实例高并发JS执行
2. 1000ms的超时设置不符合多实例排队执行的实际耗时要求
3. 若直接使用全局共享的RequestContext创建所有浏览器实例，会进一步加剧渲染进程、JS线程的资源共享冲突

解决方案 #

• 调整Cef全局启动配置，启用多渲染进程 #

  初始化Cef时显式配置命令行参数，让每个浏览器实例使用独立的渲染进程，彻底隔离JS执行线程：

  var settings = new CefSettings();
  // 禁用单进程模式
  settings.SingleProcess = false;
  // 每个浏览器实例启用独立渲染进程
  settings.CefCommandLineArgs.Add("process-per-tab");
  // 禁用渲染进程数量限制
  settings.CefCommandLineArgs.Add("renderer-process-limit", "0");
  // 正确配置子进程路径
  settings.BrowserSubprocessPath = Path.Combine(AppDomain.CurrentDomain.BaseDirectory, "CefSharp.BrowserSubprocess.exe");
  Cef.Initialize(settings);
  

• 为每个浏览器实例创建独立RequestContext #

  避免共享上下文导致的资源复用，强制隔离实例运行环境：

  // 每个实例创建独立的请求上下文，可设置独立缓存路径或使用内存缓存
  var contextSettings = new RequestContextSettings
  {
      CachePath = string.Empty, // 设为空则使用内存缓存，无需写入磁盘
      PersistSessionCookies = false
  };
  var requestContext = new RequestContext(contextSettings);
  var browser = new ChromiumWebBrowser("目标URL", requestContext: requestContext);
  

• 合理调整JS执行超时时间 #

  建议根据实际JS执行耗时将超时调整到3000ms以上，避免页面初始化阶段的额外开销导致超时：

  JavascriptResponse result = await browser.MainFrame.EvaluateScriptAsync("some JS code", timeout: TimeSpan.FromMilliseconds(5000));
  

• 延后JS执行时机 #

  不要在浏览器实例刚创建完成就调用JS，等待页面加载完成后再执行，避免阻塞：

  browser.FrameLoadEnd += async (sender, e) =>
  {
      if (e.Frame.IsMain)
      {
          // 页面主框架加载完成后再执行JS
          var result = await e.Frame.EvaluateScriptAsync("some JS code", timeout: TimeSpan.FromMilliseconds(5000));
      }
  };
  

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