Web 图形与 3D / 系统课时
检查 SkinnedMesh 的骨骼绑定
检查 SkinnedMesh 的骨骼绑定
导入 GLB 后,角色可能静止时正常,播放抬臂动画却出现拉伸尖刺、关节塌陷或局部不动。本篇通过核对骨骼层级、顶点权重和绑定姿势,再用 Three.js 的辅助骨架检查运动,判断问题出在资源还是运行时代码。
学习目标
- 解释
SkinnedMesh、Skeleton、Bone和顶点权重如何协同变形。 - 用实际脚本检查骨骼索引、权重、绑定逆矩阵及父子层级。
- 根据动画表现定位权重、骨骼层级或绑定姿势错误,并完成复验。
理清骨骼和顶点的对应关系
SkinnedMesh 持有网格 geometry 与 skeleton。Skeleton.bones 按数组索引保存 Bone 对象,而骨骼的 parent、children 形成空间层级。几何体的 skinIndex 指向 bones 中的索引,skinWeight 保存各索引对同一顶点的影响比例。数组索引不是骨骼名称,也不一定对应层级深度。
假设肘部某顶点的索引为 [2, 3, 0, 0],权重为 [0.75, 0.25, 0, 0],且第 2、3 根骨骼分别为上臂、前臂:该顶点按 75% 上臂与 25% 前臂的变换混合。四个权重应合计约为 1;仅合计正确还不够,骨骼索引也必须指向预期关节。
Skeleton.boneInverses[i] 是第 i 根骨骼在绑定姿势下的逆变换矩阵。SkinnedMesh.bindMatrix 与 bindMatrixInverse 则参与网格绑定空间变换。逆矩阵数量应与骨骼数相同,但数量相同不代表绑定姿势一定正确。

导入 GLB 并执行结构检查
准备一个已安装 three 的 Vite 工程,将包含骨骼蒙皮的资产放到 public/models/character.glb。以下完整 main.js 适用于当前 Three.js 的 GLTFLoader 接口:在浏览器控制台检查全部蒙皮网格,同时显示骨骼线框;若资源带有动画,则播放第一段动画。相机初始位置适用于原点附近、约 2 米高的角色,其他尺寸需自行调整。
import * as THREE from 'three';
import { GLTFLoader } from 'three/addons/loaders/GLTFLoader.js';
const scene = new THREE.Scene();
const camera = new THREE.PerspectiveCamera(
45, window.innerWidth / window.innerHeight, 0.1, 100
);
camera.position.set(2, 2, 5);
camera.lookAt(0, 1, 0);
const renderer = new THREE.WebGLRenderer({ antialias: true });
renderer.setSize(window.innerWidth, window.innerHeight);
document.body.style.margin = '0';
document.body.appendChild(renderer.domElement);
scene.add(new THREE.HemisphereLight(0xffffff, 0x666666, 2));
let mixer;
const clock = new THREE.Clock();
try {
const gltf = await new GLTFLoader().loadAsync('/models/character.glb');
scene.add(gltf.scene);
let meshCount = 0;
// 普通 Mesh 不含蒙皮绑定,必须单独筛选 SkinnedMesh。
gltf.scene.traverse((mesh) => {
if (!mesh.isSkinnedMesh) return;
meshCount++;
const { skeleton, geometry } = mesh;
const position = geometry.getAttribute('position');
const joints = geometry.getAttribute('skinIndex');
const weights = geometry.getAttribute('skinWeight');
if (!position || !joints || !weights) {
console.error(mesh.name, '缺少蒙皮属性');
return;
}
let invalid = 0;
let badSum = 0;
for (let v = 0; v < position.count; v++) {
let sum = 0;
for (let k = 0; k < 4; k++) {
const id = joints.getComponent(v, k);
const w = weights.getComponent(v, k);
sum += w;
// 零权重槽不参与变形,不按实际骨骼引用校验。
if (w > 0.000001 && (!Number.isInteger(id) ||
id < 0 || id >= skeleton.bones.length || !skeleton.bones[id])) {
invalid++;
}
}
if (!Number.isFinite(sum) || Math.abs(sum - 1) > 0.01) badSum++;
}
const attrsOK = joints.count === position.count &&
weights.count === position.count &&
joints.itemSize === 4 && weights.itemSize === 4;
const inverseOK = skeleton.boneInverses.length === skeleton.bones.length;
console.log(`网格 ${mesh.name}: 骨骼=${skeleton.bones.length}, 顶点=${position.count}`);
console.log(`属性匹配=${attrsOK}, 逆矩阵数量匹配=${inverseOK}, 无效影响槽=${invalid}, 权重和异常顶点=${badSum}`);
console.log('骨骼索引及父节点:', skeleton.bones.map(
(bone, i) => `${i}:${bone?.name ?? '(缺失)'} / ${bone?.parent?.name ?? '(根)'}`
).join('; '));
});
console.log('SkinnedMesh 数量:', meshCount);
// 用场景根节点创建辅助线,兼容骨骼与网格互为兄弟节点的资产。
const helper = new THREE.SkeletonHelper(gltf.scene);
helper.material.depthTest = false;
scene.add(helper);
if (gltf.animations.length > 0) {
mixer = new THREE.AnimationMixer(gltf.scene);
mixer.clipAction(gltf.animations[0]).play();
}
} catch (error) {
console.error('加载失败:', error);
}
renderer.setAnimationLoop(() => {
if (mixer) mixer.update(clock.getDelta());
renderer.render(scene, camera);
});预期输出(以包含一个有效蒙皮网格的 GLB 为例):
网格 <ID>: 骨骼=<COUNT>, 顶点=<COUNT>
属性匹配=true, 逆矩阵数量匹配=true, 无效影响槽=0, 权重和异常顶点=0
骨骼索引及父节点: <BONE_LIST>
SkinnedMesh 数量: 1<ID>、<COUNT>、<BONE_LIST> 随资产变化。播放动画时,线框应跟随关节运动,网格在肘、膝处连续弯曲;没有动画片段时只显示静止绑定。若控制台显示 SkinnedMesh 数量: 0,先确认导出的不是普通静态网格。
根据症状定位问题
| 观察结果 | 优先排查与处理 |
|---|---|
数量为 0 |
Blender 中检查网格的 Armature 修改器是否指向正确骨架,以及 GLB 是否导出了蒙皮数据。 |
属性匹配=false 或无效影响槽大于 0 |
skinIndex 和 skinWeight 数量、槽位或索引不正确;检查源文件的骨骼与网格是否被拆分重组,重新导出,不要直接重排 skeleton.bones。 |
权重和异常顶点大于 0 |
找到异常顶点对应的权重组,补齐遗漏影响并归一化。normalizeSkinWeights() 只能归一化已有数值,无法纠正错绑骨骼。 |
| 骨骼线框正常旋转,肘部却拉出尖刺 | 查看上臂、前臂对应顶点组的权重分布,检查是否把肘附近顶点赋给远处的骨骼。 |
| 静止时整块网格错位,骨骼层级和权重却正常 | 对比导出前的 Rest Position 与实际绑定姿势,检查网格和骨架对象变换及逆绑定矩阵来源。 |
特别注意:boneInverses.length === bones.length 只检查数量。若在绑定后修改了骨骼初始变换,不能靠在动画姿势下随意调用 skeleton.calculateInverses() 修复,否则会把错误姿势当作新的绑定基准。若骨骼线框完全不动,还需确认 GLB 含动画、AnimationMixer.update() 持续执行。
回到 Blender 修复并复验
以下操作以 Blender 4.5 LTS 为例,针对典型 GLB 导出链路:
- 选中角色网格,在“修改器属性 → Armature”核对
Object是否指向目标骨架;进入 Weight Paint,选中UpperArm、Forearm等顶点组,检查肘部过渡是否连续。 - 在 Weight Paint 的
Weights → Normalize All归一化权重;如需保持每顶点四根影响骨骼,先使用Weights → Limit Total并设置上限4,再归一化。缺失的影响需要先补绘,不能指望自动归一化生成。 - 选中骨架,在“骨架数据属性 → Pose”切换
Rest Position检查绑定外观;再切回Pose Position,在 Pose Mode 中单独旋转前臂约30°,观察肘部是否自然弯曲。 - 通过
File → Export → glTF 2.0输出 GLB,确保Data → Skinning启用蒙皮导出,Bone influences设为4;在骨架相关导出选项中核对是否按 Rest Position 导出,不要混用当前动画帧姿势作为绑定基准。 - 替换
public/models/character.glb并刷新页面,再检查骨骼数、父节点、无效影响槽与权重和异常顶点;至少观察抬臂0°、45°、90°三个姿势,确认骨骼线和网格同步、肘部没有尖刺。
验收时,结构检查全部通过仅代表数据基本自洽,不能替代动画姿势检查。骨骼层级正确、权重指向正确关节、绑定姿势一致,并且典型动作下网格连续变形,才算完成骨骼绑定验收。