diff --git a/src/components/image-editor/model3d-preview/Model3dViewerModel.ts b/src/components/image-editor/model3d-preview/Model3dViewerModel.ts
index e4f9516eb..e2595ee9d 100644
--- a/src/components/image-editor/model3d-preview/Model3dViewerModel.ts
+++ b/src/components/image-editor/model3d-preview/Model3dViewerModel.ts
@@ -65,8 +65,11 @@ export function resolveModel3dViewerFailureText(
       return '当前环境不支持 WebGL2，无法预览模型。';
     default: {
       // 查看器新增失败原因时这里会编译报错，不会静默退化成通用文案。
+      // 编译不过就补分支；真到运行时（宿主与查看器版本错配）仍然退回兜底文案，
+      // 不把 `decode-failed` 这类内部原因码直接显示给用户。
       const unhandledReason: never = reason;
-      return unhandledReason;
+      void unhandledReason;
+      return fallbackText;
     }
   }
 }