webbrowser控件需stathread初始化、注册表启用ie11模式、documentcompleted中线程安全读取内容、url格式规范。
WebBrowser控件拖拽后无法加载网页？检查 COM 组件初始化
WinForm 的 WebBrowser 是基于 IE 内核（Trident）的 COM 封装，必须在 UI 线程上完成 COM 初始化。如果窗体构造函数或 Load 事件中直接调用 Navigate，但主线程未标记为 [STAThread]，会静默失败或抛出 System.Runtime.InteropServices.COMException（错误码 0x800401F0）。
- 确认
Program.cs中的Main方法有[STAThread]特性（.NET 5+ 默认已加，但 .NET Framework 项目易遗漏） - 避免在非 UI 线程（如
Task.Run）中访问WebBrowser实例属性或方法 - 首次
Navigate前可加简单判断：if (webBrowser1.ReadyState == WebBrowserReadyState.Uninitialized) { webBrowser1.Navigate("about:blank"); }
如何让 WebBrowser 加载现代网页（比如含 ES6+、Flexbox）？改注册表或换内核
默认情况下，WebBrowser 使用 IE7 兼容模式（即使系统装了 Edge 或 IE11），导致很多 CSS/JS 特性不支持，页面白屏、脚本报错（如 SyntaxError: Unexpected token '）。
- 临时验证：在地址栏手动输入
javascript:alert(navigator.userAgent)，看到MSIE 7.0就是被降级了 - 强制启用 IE11 模式：向注册表
HKEY_CURRENT_USER\Software\Microsoft\Internet Explorer\Main\FeatureControl\FEATURE_BROWSER_EMULATION添加字符串值，名称为你的程序名（如MyApp.exe），值设为11001（十进制） - 注意：管理员权限不是必须的，但该键路径对当前用户有效；若部署给他人，需在安装时写入注册表
- 替代方案：改用
CefSharp.WinForms（Chromium 内核），但体积大、打包复杂，适合长期维护项目
怎么安全地从 WebBrowser 获取网页内容并防止跨线程异常？
直接读 webBrowser1.Document.Body.InnerHtml 很容易触发 System.Threading.ThreadStateException，因为 DOM 访问必须等页面完全就绪且在 UI 线程执行。
- 只在
DocumentCompleted事件中读取内容，且要过滤掉 iframe 的多次触发：if (e.Url == webBrowser1.Url) { /* 处理主文档 */ } - 不要在事件里直接操作其他控件（如
textBox1.Text = ...），除非确认当前在线程上；稳妥做法是用this.Invoke((MethodInvoker)delegate { textBox1.Text = doc.Body.InnerHtml; }); - 若需解析 HTML，推荐用
HtmlAgilityPack加载webBrowser1.DocumentText（字符串），而非直接操作Document对象，更稳定且无线程风险
WebBrowser.Navigate() 不生效或跳转后空白？排查 URL 和协议限制
WebBrowser 对 URL 格式敏感，且默认禁用某些协议（如 file:// 本地路径可能被安全策略拦截），还会因空格、中文未编码导致静默失败。
- 确保 URL 是完整格式：以
http://、https://或file:///（注意三个斜杠）开头；file://c:\test.html会失败，应改为file:///c:/test.html - 中文路径或参数必须用
Uri.EscapeUriString()编码，例如：webBrowser1.Navigate(Uri.EscapeUriString("https://example.com/搜索?q=中文")); - 调试技巧：在
Navigate后立即检查webBrowser1.StatusText，若显示 “Navigation cancelled” 或 “Failed to load”，基本是 URL 格式或安全策略问题
WebBrowser 的坑多数藏在“它看起来动了，其实没真加载”这种状态里——ReadyState 可能卡在 Interactive，DocumentCompleted 可能触发多次，DOM 属性访问时机稍错就崩。别信“只要写了 Navigate 就一定行”。
