环境:LayaAir 3.3.13(引擎文件日期 2026-09-15),WebGL 渲染,Chrome 与移动 WebView 均可复现。

现象:Sprite 设置 mask 或 postProcess 后(即 _renderType 含 SpriteConst.DRAW2RT 位:MASK / POSTPROCESS / CANVAS),该节点及其子节点完全不渲染,无任何报错。节点树状态一切正常:visible=true、active=true、纹理已加载、_oriRenderPass / _drawOriRT 已分配、_subpassUpdateFlag 置位后在渲染循环中被正常清零(说明 RT 更新链路有执行),但最终合成到屏幕的内容为全空。普通节点不受影响。scrollRect(CLIP)不受影响。

最小复现(新建空项目,入口添加以下代码,三色块):

// 1. 普通 Sprite:正常显示(红)
const plain = new Laya.Sprite();
plain.pos(100, 300);
plain.graphics.drawRect(0, 0, 200, 200, "#ff0000");
Laya.stage.addChild(plain);

// 2. 带 mask:整块消失(绿)
const masked = new Laya.Sprite();
masked.pos(350, 300);
masked.graphics.drawRect(0, 0, 200, 200, "#00ff00");
const maskSpr = new Laya.Sprite();
maskSpr.graphics.drawRect(0, 0, 100, 100, "#ffffff");
masked.mask = maskSpr;
Laya.stage.addChild(masked);

// 3. 带 postProcess(恒等 ColorEffect2D):整块消失(蓝)
const ppSprite = new Laya.Sprite();
ppSprite.pos(600, 300);
ppSprite.graphics.drawRect(0, 0, 200, 200, "#0000ff");
const pp = new Laya.PostProcess2D();
pp.effects = [new Laya.ColorEffect2D()];
ppSprite.postProcess = pp;
Laya.stage.addChild(ppSprite);

期望:红、绿、蓝三个色块都显示(绿块被遮罩裁剪为 100×100,蓝块经恒等颜色矩阵直通)。
实际:只有红色块显示,绿、蓝两块不可见,无任何报错。

补充排查:

帧末同步 canvas.toDataURL 抓帧,确认内容确实未绘制,排除截图时机/合成阶段问题;
相同场景改用 scrollRect 裁剪则一切正常(CLIP 未命中 DRAW2RT),可作为业务侧绕过方案;
影响:依赖 mask 与 postProcess 的业务 UI(跑马灯图标裁剪、发光滤镜等)全部静默不可见,排查成本很高。