本页介绍了如何排查 Looker 中的 RendererNoRenderFinishedEventReceivedError 错误。此错误消息通常表示生成下载内容和时间表的 PNG 和 PDF 可视化效果的 Chromium 渲染器存在问题。
排查 Chromium 渲染器兼容性问题
请使用以下决策树排查渲染器兼容性问题。在新标签页中打开决策树以放大显示。
问题排查步骤
以下部分将更详细地介绍树中的场景。
第 1 步：验证 Chromium 版本
RendererNoRenderFinishedEventReceivedError 的根本原因可能是 Looker 实例与客户主机服务器上安装的 Chromium 或 Google Chrome 版本不匹配。
如需精确定位 Chromium 版本及其安装路径，请使用以下命令：
chromium --version
which chromium
将输出版本与 Looker 兼容版本列表进行比较。如需查看支持的版本列表，请参阅客户自托管的渲染软件安装页面。
如果版本不兼容，请前往第 2B 步：执行战略性回滚。否则，请继续执行第 2A 步：检查安装和配置
第 2A 步：查看安装和配置
如果您使用的是客户自托管的 Looker 实例，请查看渲染软件安装文档，确保配置正确。
如果一切正常，请继续执行第 3A 步：分析日志。
第 3A 步：分析日志
仔细检查 Looker 日志，查找与 Chromium 的状态、其与开发者工具的连接或任何失败的通信尝试相关的错误。查找可提供有关潜在问题的线索的重复模式或特定错误消息。
如果您在日志中未找到任何问题，请继续前往最终审核和支持。
第 2B 步：执行战略性回滚
如果 Chromium 版本不兼容，通常最有效的解决方案是战略性回滚到已知兼容的版本（例如 Chromium 97、109 或 114）。如果您需要有关回滚 Chromium 版本的帮助，请与 Looker 支持团队联系。
在回滚过程中，您可能会遇到以下问题。
第 3B 步：404 错误和软件包缺失
遇到 404 错误或缺少软件包可能会中断回滚程序。确保已正确配置并可访问必要的软件包代码库。如有需要，请手动下载并安装缺少的软件包。
第 3C 步：权限问题
权限不足可能会妨碍创建或修改回滚所需的目录。授予适当的用户权限以执行回滚流程。如有必要，可使用 sudo 或等效命令暂时提升权限。
第 3D 步：dpkg 前端锁定错误
在基于 Debian 的系统中，dpkg 前端锁定可以防止并发软件包操作。等待所有正在进行的软件包操作完成。如果前端似乎存在锁定，但不会随时间消失，请备份您的实例，然后使用以下命令强制解锁前端：
sudo rm /var/lib/dpkg/lock
第 3E 步：停用 Chromium 自动更新
在客户托管的环境中，自动 Chromium 更新可能会无意中引入兼容性问题。实施措施以防止 Chromium 自动更新。建立例行程序，主动监控 Chromium 版本，并仅在确保与 Looker 兼容时执行手动更新。
最终审核和支持
如果这些问题排查步骤无法解决该错误，请与支持团队联系，以便进一步排查问题。