[WebGL2] RendererInstanceData 直接消费 MAX_UNIFORM_BLOCK_SIZE 导致巨型 GLSL 数组和 context loss
I maintainer di solito rispondono entro 1 giorno
Nessuno ha ancora preso questa issue.
Valutazione
- Difficoltà
- 5/5
- Tempo stimato
- Più di una settimana
- Idoneità per principianti
- 35/100
- Tipo di issue
- Bug
- Chiarezza
- Abbastanza chiara
- Stato di attività
- Attiva
- Stack tecnologico
- typescript
- Ambito
- computer-graphics
Direzione di ricerca
Start by locating the GPU Instancing code that computes instanceMaxCount from MAX_UNIFORM_BLOCK_SIZE and generates the RendererInstanceData shader declaration; the issue does not name its file or tests. Review PR #3093 as the temporary mitigation and the cited ANGLE uniform-block behavior, then evaluate a durable capacity strategy across devices, shader caching, context restore, and batching performance. Done means the design and implementation avoid oversized shader arrays while respecting smaller device limits and are validated across the affected environments.
Scritto dal modello di indicizzazione a partire dal testo della issue.
Descrizione
问题描述
Galacean 的 GPU Instancing 路径会直接使用设备报告的 MAX_UNIFORM_BLOCK_SIZE 计算 RendererInstanceData 的静态数组长度:
const instanceMaxCount = Math.floor(maxUBOSize / structSize);
在 vivo X200 的旧版钉钉 WebView 中,WebGL2 返回 MAX_UNIFORM_BLOCK_SIZE = 134217728(128 MiB)。当每个实例结构为 64 bytes 时,最终生成包含 2,097,152 个元素的 vertex uniform block 数组:
struct RendererInstanceStruct {
mat3x4 renderer_MVPMat;
ivec4 renderer_Layer;
};
layout(std140) uniform RendererInstanceData {
RendererInstanceStruct rendererData[2097152];
};
至少两个兼容 renderer 形成 GPU Instancing batch 后,旧 Mali/Chromium GL 路径在处理该巨型静态数组声明时发生 WebGL context loss,页面在首帧前黑屏。
问题不是 GPU Instancing 本身,而是把设备能力上限直接转换为运行时批次容量和静态 GLSL 数组长度。
已复现版本为 @galacean/[email protected];experimental-2.0-migrate.6 和当前 feat/migrate-2.0 仍包含相同的直接计算逻辑。
复现环境
| 环境 | GPU | MAX_UNIFORM_BLOCK_SIZE |
结果 |
|---|---|---|---|
| vivo X200,钉钉 7.6.35.27,Chrome 100 / UWS 5.12.5.0 | Mali-G925-Immortalis MC12 | 134217728(128 MiB) | 首帧前 context loss,黑屏 |
| 同一台 vivo X200,Chrome 130 | Mali-G925-Immortalis MC12 | 65536(64 KiB) | 首帧和 heartbeat 正常 |
| 红米 24122RKC7C,同版本钉钉和 UWS | Adreno 830 | 65536(64 KiB) | 首帧和连续 heartbeat 正常 |
A/B 定位证据
| 实验 | 结果 | 结论 |
|---|---|---|
instancing=0 |
不黑屏 | 故障仅在 GPU Instancing 路径触发 |
| 只保留一个 renderer | 不黑屏 | 未形成对应的 instancing batch |
| 保留两个可合批 renderer | 黑屏 | 两个实例即可触发,与场景对象总量无关 |
instanceCap=2:只缩小 shader 数组长度,保留原 128 MiB 底层布局和 Buffer |
不黑屏 | 128 MiB Buffer 分配不是直接触发点,巨型 GLSL 数组声明才是关键条件 |
instanceFragmentUbo=0:移除 fragment shader 的 UBO 访问,保留满尺寸 vertex UBO |
黑屏 | fragment UBO 访问不是必要条件,vertex 侧声明即可触发 |
uboLimit=16384:保留 GPU Instancing,限制实例 UBO 容量 |
不黑屏,项目正常运行 | 缩小数组声明后不再发生 context loss |
期望行为
RendererInstanceData 应当拥有独立、稳定且可验证的实践容量,不应把驱动返回的理论最大 uniform block size 直接用作静态数组长度。设备报告异常大的上限时,不应生成巨型 shader 声明或导致 context loss;设备真实上限较小时仍必须遵守该上限。
临时修复与正式方案
PR #3093 当前通过 min(MAX_UNIFORM_BLOCK_SIZE, 64 KiB) 限制 RendererInstanceData,作为已知问题的临时止血方案。它保持设备能力值不变,只限制实例 UBO 布局预算。
但 64 KiB 尚不能直接视为最终设计。正式方案仍需要评估:
- shader 静态数组容量是否应与底层 Buffer 容量解耦;
- 默认实例批次上限应如何确定,是否需要可配置或自适应策略;
- 不同 GPU、浏览器、WebView 和驱动组合下的兼容性;
- 限制批次大小后的性能和 draw call 变化;
- shader cache、context restore 与设备切换时的一致性。
建议由本 Issue 跟踪长期设计、跨设备验证和最终实现,PR #3093 只作为临时 mitigation。
相关资料
- Lingua principale
- TypeScript
- Stelle
- 5.9k
- Fork
- 413
- Merge medio
- 16h 17m
- PR unite (30g)
- 41
Preparare l'ambiente
- Nessun Dockerfile né file Docker Compose
- Ha un modello di pull request
- Nessuna guida per i contributori
Come iniziare
- Leggi tutta la issue e poi la guida ai contributi del progetto.
- Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
- Fai un fork del repository e lavora su un branch.
- Apri una pull request che faccia riferimento al numero della issue.
Altre issue di galacean/engine
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 64/100
I maintainer di solito rispondono entro 1 giorno
-
Difficoltà 1/5 Meno di un'ora Idoneità per principianti 85/100
I maintainer di solito rispondono entro 1 giorno
-
Difficoltà 4/5 3-5 giorni Idoneità per principianti 52/100
I maintainer di solito rispondono entro 1 giorno
-
RFC: Adopt Unity-style Collider components and hierarchical Rigidbody ownershipForse già presa Una pull request collegata a questa issue è aperta o già unita. Aperta
Difficoltà 5/5 Più di una settimana Idoneità per principianti 20/100
I maintainer di solito rispondono entro 1 giorno
-
SkinnedMeshRenderer should derive default rootBone-space localBounds from mesh and skinForse già presa Una pull request collegata a questa issue è aperta o già unita. Apertaenhancement
Difficoltà 4/5 3-5 giorni Idoneità per principianti 42/100
I maintainer di solito rispondono entro 1 giorno
Tutte le issue di galacean/engine
Issue simili
-
bug impact:low Team: SecuritySolution Team:Defend Workflows v9.6.0
Difficoltà 2/5 1-3 ore Idoneità per principianti 72/100
elastic/kibana#306401 · 3 commenti ·
I maintainer di solito rispondono entro 1 giorno
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 68/100
agentes-chat/agentes-chat#927 ·
I maintainer di solito rispondono entro 1 giorno
-
[Bug]: Webapp workspace fails to render in Safari — "Can't find variable: requestIdleCallback"Apertacomp/desktop P2 type/bug
Difficoltà 2/5 1-3 ore Idoneità per principianti 78/100
NousResearch/hermes-agent#157702 ·
I maintainer di solito rispondono entro 1 giorno
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 76/100
I maintainer di solito rispondono entro 1 giorno
-
e2e-failure ready-to-code
Difficoltà 1/5 Meno di un'ora Idoneità per principianti 72/100
redhat-developer/rhdh-plugin-export-overlays#4794 · 1 commento ·
I maintainer di solito rispondono entro 1 giorno