重建失败的 6 种典型 case 与降级路径3DGS 重建失败的原因五花八门输入拍得太烂、物体本身没特征、机器内存不够、重建跑超时、设备不支持、结果出来质量太差。每种失败的降级方案不一样——OOM 该清数据还是保留超时该用部分结果还是直接放弃结果质量差该重算还是给用户凑合看我们踩过最坑的 case 是 OOM 降级把用户拍了 5 分钟的素材清掉了用户骂我白拍了。降级不是技术问题是体验取舍。能力面6 种典型失败Spatial Recon Kit 的重建失败集中在 6 种每种有对应错误码和检测时机失败类型错误码检测时机是否可重试输入不足INPUT_INSUFFICIENT重建开始前是引导重拍特征缺失FEATURE_SPARSE特征提取阶段是换角度重拍OOMOUT_OF_MEMORY任意阶段部分降质重试超时RECON_TIMEOUT任意阶段部分部分结果设备不支持DEVICE_NOT_SUPPORTEDsession 创建时否降级方案结果质量差QUALITY_LOW重建完成后是调参重试前两种在输入门禁阶段就该挡掉。后四种是门禁过了、重建过程中出问题是这篇的重点。六种失败各走一条降级路但都汇到同一个校验出口INPUT_INSUFFICIENTFEATURE_SPARSEOUT_OF_MEMORYRECON_TIMEOUTDEVICE_NOT_SUPPORTEDQUALITY_LOW通过仍失败重建失败读取错误码引导重拍引导换角度重拍从独立备份重新加载降质到 540p 与帧数减半放弃结果引导减少拍摄范围回退全景图预览调参重试增加迭代次数降级后校验明确告知损失后放行提示重新拍摄降级动作各异出口只有告知损失后可用和重拍两个别静默降级。约束面每种失败的降级方案与体验损失降级方案不是让重建成功是让用户不至于骂街。每种降级都伴随体验损失要明确告诉用户损失了什么失败类型降级方案体验损失用户感知输入不足引导重拍时间“请按引导重新拍摄”特征缺失引导换角度时间“物体纹理太少请换角度”OOM降质重建减帧/降分辨率重建质量“内存不足已降低质量重建”超时用部分结果 or 放弃重建完整度“重建超时已用部分结果”设备不支持回退 Mesh/全景图重建能力“当前设备不支持已切换预览模式”结果质量差调参重试 or 凑合用重建质量“结果质量一般是否重新计算”降级方案的核心是明确告知损失不要静默降级。用户宁可看到质量降低了的提示也不愿看到不知道哪里不对的怪结果。场景落地6 种失败的实际触发与降级商品展示场景跑了 500 次真实重建统计每种失败的发生频率和降级后体验失败类型发生次数占比降级耗时降级后用户评分降级后是否可用输入不足479.4%引导重拍 2-5min4.1/5重拍后可用特征缺失234.6%引导换角度 1-3min3.8/5可用OOM316.2%降质重建 8-15s3.2/5勉强可用超时183.6%部分结果 0s2.4/5不可用多数设备不支持122.4%回退全景图 200ms3.6/5可用结果质量差357.0%调参重试 12-20s3.9/5可用无失败33466.8%—4.5/5可用几个值得注意的点超时降级用部分结果体验评分最低 2.4/5。部分结果通常是物体一半重建出来、另一半是大洞。后来改成放弃 引导减少拍摄范围重拍评分升到 3.7/5。OOM 降质重建能用但评分不高降质是把帧数砍半、分辨率降到 540p。结果质量差调参重试效果最好重试 12-20s 后 80% 能拿到合格结果。设备不支持回退全景图体验意外地好3.6/5 比 OOM 降质还高。踩坑OOM 降级清了用户素材第一个版本 OOM 降级逻辑检测到内存压力 → 销毁当前 session 释放内存 → 用降质配置重新创建 session → 重新加载素材。问题出在销毁 session——session 销毁会把已加载的原始帧数据也清掉。用户拍了 5 分钟环绕视频重建跑到 70% 时 OOM降级触发素材清空。两周收到 11 个投诉。修复方式是把原始素材在 session 创建时拷一份到应用沙箱临时目录OOM 降级时从临时目录重新加载。代价是存储多占一份200 帧 1080p 视频约 80-120MB但素材不丢。// entry/src/main/ets/recon/FailureHandler.etsimport{spatialRecon,ReconSession}fromkit.SpatialReconKit;import{fs}fromkit.FileSystemKit;exportclassFailureHandler{// 重建失败统一入口staticasynchandle(error:ReconError,ctx:ReconContext):PromiseReconResult{switch(error.code){caseOUT_OF_MEMORY:returnthis.handleOOM(ctx);caseRECON_TIMEOUT:returnthis.handleTimeout(ctx);caseQUALITY_LOW:returnthis.handleLowQuality(ctx);caseDEVICE_NOT_SUPPORTED:returnthis.handleUnsupported(ctx);caseFEATURE_SPARSE:returnthis.handleSparseFeature(ctx);default:returnthis.handleUnknown(error,ctx);}}// OOM 降级从临时目录重新加载素材降质重建privatestaticasynchandleOOM(ctx:ReconContext):PromiseReconResult{// 素材已在 session 创建时备份到 ctx.backupDir不依赖 session 内存constbackupFramesawaitfs.listDir(ctx.backupDir);if(backupFrames.length0)return{status:fail,reason:素材丢失请重新拍摄};// 降质帧数砍半分辨率降到 540pconstdegradedConfig{...ctx.originalConfig,maxFrames:Math.floor(ctx.originalConfig.maxFrames/2),targetResolution:540,};constsessionawaitspatialRecon.createReconSession(degradedConfig);awaitsession.loadFrames(backupFrames);// 从备份加载不依赖用户重拍returnsession.reconstruct();}// 超时降级放弃部分结果引导减少拍摄范围重拍privatestaticasynchandleTimeout(ctx:ReconContext):PromiseReconResult{// 试过用部分结果体验评分 2.4/5改成放弃 引导评分 3.7/5return{status:fail,reason:重建超时建议减少拍摄范围或物体大小后重试,guide:reduce_range};}}这段代码的关键是OOM 降级不能依赖 session 内存里的素材必须从独立备份重新加载。被放弃的方案试过 OOM 自动重试三次每次降一档。第三次降到底线质量重建出来还是垃圾用户等了 45 秒最后看到糊成马的结果。后来改成只降一次降到 540p 还不行就直接 fail。踩坑超时降级用部分结果更差超时降级有两种选择用部分结果或直接放弃。我们一开始选了用部分结果理由是用户等了那么久总得给点东西。实际跑下来部分结果几乎不可用。3DGS 重建是迭代优化跑到 60% 超时的结果物体只有一半区域有高斯点覆盖。改成直接放弃后UI 提示重建超时建议减少拍摄范围用户反而觉得应用诚实。有时候放弃比凑合更好。失败-降级映射表最终版失败类型降级动作是否保留素材是否重试用户体验输入不足引导重拍是—烦但能接受特征缺失引导换角度是—烦但能接受OOM降质重建540p 帧数减半是独立备份1 次质量降级但能用超时放弃 引导减少范围是—诚实告知引导重拍设备不支持回退全景图预览——能力降级但能看结果质量差调参重试增加迭代是1 次多等 15s80% 能修好真机数据降级前后的用户评分对比500 次真实重建里触发降级 166 次对比无降级和走降级路径失败类型无降级评分走降级评分评分差放弃率差输入不足1.2/5垃圾结果4.1/5重拍后2.9-32%特征缺失1.5/53.8/52.3-25%OOM1.0/5崩溃3.2/52.2-41%超时2.4/5部分结果3.7/5放弃引导1.3-18%设备不支持1.0/5崩溃3.6/5全景图2.6-45%结果质量差2.8/53.9/51.1-12%降级在所有 case 上都显著提升评分和降低放弃率。最明显的是设备不支持——直接崩溃评分 1.0回退全景图评分 3.6。几个细节QUALITY_LOW在重建完成后用 SSIM 比对耗时约 200ms。OOM 降质重建只重试 1 次再 OOM 就直接 fail。降级提示要具体。质量降低是废话已降至 540p才是有效信息。设备不支持的降级要提前做在设备门禁阶段就判。素材备份清理策略要补上。一开始没清理用户重建 10 次后沙箱占好几 GB。总结一下6 种失败要有统一处理入口OOM 降级必须从独立备份重新加载素材超时降级直接放弃 引导更好降级重试最多 1 次降级提示要明确告知损失设备不支持要在门禁阶段提前降级素材备份要有清理策略6 种失败降级路径跑通后下一步收集线上数据看每种失败的实际占比。内测 500 次的数据线上分布可能不同——线上中端机占比更高OOM 和超时占比可能翻倍。下一篇拆 9020 和 9030 性能差异。