Go应用集成webview在部分纯净安装Windows系统无法渲染本地服务页面

根因定位 #

这个故障是Windows平台WebView2运行时的默认安全策略导致的：微软WebView2（go-webview在Windows上的底层依赖）默认会禁止应用访问本地环回地址（127.0.0.1/localhost），仅开发环境或手动配置过环回豁免的设备可以正常访问。你观察到的旧设备正常、新纯净系统故障，正是因为旧设备可能之前做过开发配置、已经开启了环回豁免，而新系统没有相关配置。

排查方案 #

• 首先在故障设备上打开WebView2的开发者工具：你代码中webview.New(true)已经开启了调试模式，在空白的webview窗口上右键选择「检查」，切换到「网络」标签刷新页面，查看请求报错信息，如果出现ERR_ACCESS_DENIED类错误，即可确认是环回权限问题。
• 查看故障设备的WebView2运行时版本：在「设置-应用-安装的应用」中搜索「Microsoft Edge WebView2 Runtime」，对比正常设备和故障设备的版本，排查是否有版本兼容性问题。

解决方案 #

临时验证方案 #

在故障设备上以管理员身份运行命令提示符，执行以下命令添加WebView2的环回豁免：

CheckNetIsolation.exe LoopbackExempt -a -n="Microsoft.Win32WebViewHost_cw5n1h2txyewy"

执行完成后重新打开你的应用，确认是否可以正常加载本地页面。

代码级永久修复方案 #

在初始化WebView2环境时主动开启环回访问权限，修改OpenUI函数如下：

import "runtime"

func OpenUI(url string) {
    log.Print("Starting OpenUI")
    // Windows平台提前设置WebView2环境参数开启环回访问
    if runtime.GOOS == "windows" {
        err := webview.SetEnvironmentOption("WEBVIEW2_ADDITIONAL_BROWSER_ARGUMENTS", "--allow-loopback")
        if err != nil {
            log.Printf("set webview env failed: %v", err)
        }
    }
    w := webview.New(true)
    defer w.Destroy()

    w.SetTitle("Webview Window")
    w.SetSize(800, 600, webview.HintFixed)
    w.Navigate(url)
    w.Run()
}

如果使用的旧版本webview库不支持SetEnvironmentOption，可以换用以下两种方案：

1. 将本地服务监听地址从127.0.0.1改为localhost，部分版本的WebView2会对localhost做特殊放行
2. 打包时内置安装脚本，在用户首次运行应用时自动执行上述CheckNetIsolation命令添加豁免

其他可选优化 #

• 避免使用8080、3000这类常用开发端口，改用随机未占用端口启动本地HTTP服务，规避端口被安全策略拦截的问题
• 打包时将WebView2运行时的离线安装包一起打包，避免用户设备缺少对应依赖

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