glTF 四元数顺序写反后模型乱转，怎样核对 xyzw 与归一化

glTF节点rotation按[x,y,z,w]保存单位四元数，其中w是标量。把常见的[w,x,y,z]直接写进去，可能得到范数仍正确但姿态完全不同的结果，因此只验长度为4或范数为1还不够。至少用一个已知90度旋转，比较前向与上向两根向量，避免某个方向碰巧相同而漏检。

环境和证据范围

本文使用glTF节点四元数和列向量旋转公式，单位范数容差为1e-6的合成判据。不是所有引擎API都采用同一参数顺序，适配时要读其官方文档；不调用渲染引擎，不做实际模型动画或硬件姿态测试。

核对顺序

1. 先在源数据与目标字段两侧分别标明分量顺序，禁止用“rotation数组”这种不完整说明。欧拉角、轴角与四元数也不是同一种输入，角度值不能直接填进四元数分量。

2. 检查四个数有限且范数接近1。明显不单位的输入先拒绝并回查来源，不默默归一化掩盖导出错误；若允许微小误差修正，应记录容差和修正前后值。

3. 用单位姿态与绕Y正向90度样例，分别旋转前向[0,0,1]和上向[0,1,0]。比较两根基向量能识别某些顺序错但前向碰巧正确的反例。

4. 把四元数与其整体取负的表示视为同一空间旋转，不能只逐分量相等判断姿态不同。动画插值时还要按引擎与格式规则处理连续性，本页只检查单个旋转输入。

可复算的输入与预期

正确Y轴90度四元数[0,√0.5,0,√0.5]把前向变成[1,0,0]，上向保持[0,1,0]。若把wxyz误当xyzw输入[√0.5,0,√0.5,0]，前向仍是[1,0,0]，上向却变为[0,-1,0]；这正说明只测前向会漏错。另有[0,0,0,2]被判为非单位。

下载与现场记录

下载本题合成输入与预期JSON、离线只读核验脚本和现场空白记录CSV。放在同一目录，用 Python 3 运行 python verify.py，逐项计算或解析后与预期比较，失败会显示差异。

现场字段包括 source_order、target_order、quaternion、norm、forward_result、up_result、tolerance。合成样例保持原样，实测另存并填写型号、版本、证据路径，未采集处留空。本地核验不代表真实设备、代理、浏览器或长期稳定性已测。

失败分支与移交

接近单位范数不等于业务朝向正确，轴基准错、父变换错都能产生合法四元数。q与-q的等价也不表示任意分量换序都等价。若静态姿态正确而动画中翻转，需另看关键帧连续性与插值，不能通过交换两个分量试到截图好看为止。

交接时附分量顺序、容差、源坐标系、两个基向量期望和目标API映射。真实模型还要验证带非对称标记的姿态与父层级；本文输出仅为合成向量计算，未声明任何数字孪生平台已原生完成该校验。

基础背景可看孪生三维建模四条路线怎么选：手工建模 / BIM 转换 / 倾斜摄影 / 激光点云。旋转输入正确后，还要检查父子层级组合，见子模型偏移总差一段，怎样按 glTF 节点层级计算 TRS。更多资料在数字孪生技术方案。

需要项目联调时，可按上述字段整理资料，联系企服君核对实际接入范围。

一级资料

• 官方资料：node.rotation按x,y,z,w顺序且为单位四元数

核对日期：2026-10-24。规范定义与本文应用约定分开，示例门限及脚本不自动代表产品原生能力。