Kedro viz在Windows 10显示空白页，WSL运行正常，求解决方案

原因分析 #

结合你提供的信息（Windows本地异常、WSL正常，终端无报错但浏览器控制台有异常），核心问题是Kedro Viz 6.x旧版本在Windows环境下的路径解析兼容性bug：

• 旧版Kedro Viz无法正确处理Windows风格的盘符（如C:\）或反斜杠路径，导致前端静态资源加载失败，页面空白。
• 也可能是Windows防火墙/杀毒软件拦截了资源请求，或者端口被占用但终端未提示。

解决办法 #

1. 临时复用WSL环境启动 #

直接在Windows终端里用WSL命令运行Kedro Viz，规避Windows路径问题：

wsl kedro viz

访问http://localhost:4141即可，和你WSL里的正常效果一致。

2. 调整Kedro Viz配置 #

打开项目根目录的kedro.yml，添加/修改Viz配置，强制使用相对路径加载资源：

viz:
  port: 4141
  host: 0.0.0.0
  load_file: data/

保存后清空浏览器缓存（Ctrl+Shift+Delete），再重新运行kedro viz。

3. 升级到新版本（推荐） #

你当前的Kedro（0.18.14）和Kedro Viz（6.6.1）版本较旧，后续版本已修复大量Windows兼容性问题：

pip install --upgrade kedro kedro-viz

升级完成后重新执行kedro viz，基本能解决路径解析类的问题。

4. 排查端口与防火墙 #

• 检查4141端口是否被占用：

  netstat -ano | findstr :4141
  

  若有占用，杀掉对应进程或换端口启动：

  kedro viz --port 4142
  

• 临时关闭Windows Defender防火墙或第三方杀毒软件，确认是否是拦截导致资源加载失败。

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