Plotly.js 项目中 Chrome 128 版本的 WebGL 渲染问题分析

问题背景

近期在 Plotly.js 项目中，用户报告了一个与 WebGL 渲染相关的严重问题。该问题主要影响 Chrome 浏览器 128 版本，导致包含 parcoords（平行坐标）、mesh3d（3D 网格）和 surface（曲面）等 WebGL 轨迹的图表无法正常渲染。

问题表现

当用户在 Chrome 128 版本中尝试渲染上述类型的图表时，控制台会抛出以下错误信息：

TypeError: Failed to execute 'uniformMatrix4fv' on 'WebGLRenderingContext': The provided float value is non-finite.

这个错误表明浏览器在执行 WebGL 着色器的 uniform 矩阵赋值时遇到了非有限数值（NaN 或 Infinity），导致渲染过程中断。

影响范围

该问题不仅影响了 Plotly.js 项目，还波及了其他依赖 WebGL 技术的应用程序。例如，一些 GIS 地图应用也报告了类似的渲染问题。问题同时出现在 Chrome 128 和基于 Chromium 的 Edge 128 浏览器中。

技术分析

WebGL 是一种基于 OpenGL ES 的 JavaScript API，用于在浏览器中呈现交互式 3D 和 2D 图形。uniformMatrix4fv 是 WebGL API 中的一个方法，用于将 4x4 矩阵传递给着色器程序。

在正常情况下，这个方法期望接收一个包含 16 个有限浮点数值的数组。然而，在 Chrome 128 版本中，某些情况下传递的矩阵值可能包含非有限数值（NaN 或 Infinity），这违反了 WebGL 规范，导致渲染失败。

解决方案

Chromium 团队已经确认这是一个回归问题（即新版本中引入的 bug），并将其标记为高优先级（P1）问题。该问题已在 Chrome 128.0.6613.113 版本中得到修复。

对于遇到此问题的用户，建议采取以下措施：

1. 将 Chrome 浏览器更新至 128.0.6613.113 或更高版本
2. 如果无法立即更新浏览器，可以考虑暂时使用其他浏览器（如 Firefox 或 Safari）来查看 WebGL 内容
3. 对于开发者，可以在代码中添加错误处理逻辑，捕获并记录此类异常

总结

浏览器更新有时会引入意想不到的兼容性问题，特别是像 WebGL 这样复杂的图形技术。Plotly.js 团队及时发现了这个问题，并与 Chromium 团队合作推动修复，展现了开源社区的高效协作。

对于依赖 WebGL 技术的开发者来说，这是一个提醒：在浏览器大版本更新后，应该对关键功能进行全面测试，并密切关注相关社区的问题报告。同时，保持浏览器更新是避免此类问题的最佳实践。