Cesium报错：normalized result is not a number，如何定位与解决？

Question

在Cesium开发中，遇到“normalized result is not a number”报错时，通常是由于向量归一化操作中出现了零向量或无效数值。此问题常见于计算法线、方向向量或视点位置等场景。定位方法：检查涉及`Cartesian3.normalize`函数的代码，确认输入向量是否为零向量（如`new Cartesian3(0, 0, 0)`）。解决办法包括在归一化前验证向量长度，使用`Cartesian3.magnitude`判断是否大于零；若为零向量，需回溯数据来源，修正生成逻辑或提供默认值替代。例如，在处理鼠标拾取或几何计算时，确保输入数据合法且非空。此外，启用Cesium调试模式（如设置`Cesium.DeveloperError.throwInstantly = true`）可帮助快速定位问题根源。

Answer 1

1. 问题概述

在Cesium开发中，当遇到“normalized result is not a number”报错时，通常是因为向量归一化操作中出现了零向量或无效数值。这种错误常见于计算法线、方向向量或视点位置等场景。

例如，在处理3D模型的光照效果时，如果法线向量为零向量，则会导致归一化失败并抛出该错误。以下是可能出现问题的代码片段：

let vector = new Cesium.Cartesian3(0, 0, 0);
let normalizedVector = Cesium.Cartesian3.normalize(vector, new Cesium.Cartesian3());

上述代码会触发错误，因为输入向量是一个零向量。

2. 分析过程

要定位问题根源，需要检查涉及Cartesian3.normalize函数的代码，并确认输入向量是否为零向量。以下是从浅到深的分析步骤：

1. 检查代码中所有调用Cartesian3.normalize的地方。
2. 使用Cartesian3.magnitude判断向量长度是否大于零。
3. 若发现零向量，回溯数据来源，分析生成逻辑是否存在漏洞。
4. 启用Cesium调试模式（如设置Cesium.DeveloperError.throwInstantly = true），捕获更多上下文信息。

通过这些步骤，可以逐步缩小问题范围，找到具体原因。

3. 解决方案

解决此类问题的关键在于预防和处理零向量。以下是几种常见的解决方案：

• 验证向量长度：在归一化前，使用Cartesian3.magnitude判断向量长度是否有效。
• 提供默认值：若检测到零向量，可为其分配一个合理的默认值。
• 修正数据生成逻辑：确保数据来源合法且非空，例如在鼠标拾取或几何计算时避免生成零向量。

以下是改进后的代码示例：

let vector = calculateVector(); // 假设这是生成向量的函数
if (Cesium.Cartesian3.magnitude(vector) === 0) {
    vector = new Cesium.Cartesian3(1, 0, 0); // 提供默认值
}
let normalizedVector = Cesium.Cartesian3.normalize(vector, new Cesium.Cartesian3());

4. 调试辅助工具

为了更高效地定位问题，可以结合Cesium的调试功能。例如，启用Cesium.DeveloperError.throwInstantly可以在运行时立即抛出错误，帮助开发者快速发现问题所在。

以下是启用调试模式的代码：

Cesium.DeveloperError.throwInstantly = true;

此外，还可以通过流程图展示问题排查的逻辑：

sequenceDiagram
    participant Developer as 开发者
    participant Code as 代码
    participant Debugger as 调试工具
    Developer->>Code: 检查 normalize 调用
    Code->>Developer: 返回零向量提示
    Developer->>Debugger: 启用 throwInstantly
    Debugger-->>Developer: 提供详细错误信息