Unreal Engine安卓游戏GLSL链接错误:out_var_TEXCOORD6冲突排查
以下是针对该错误的核心原因分析及排查方向:
变量Location手动指定重复
如果你的顶点/片段着色器中手动通过layout(location = N)指定了变量位置,可能存在多个变量共用同一个N值的情况,包括out_var_TEXCOORD6和其他输出/输入变量。Unreal默认会自动为Shader变量分配location,但手动指定时若未做好全局唯一性检查,就会触发位置冲突。Unreal自动注入变量的冲突
Unreal编译安卓平台Shader时,会根据材质节点、渲染管线需求自动注入一些内置变量(比如光照采样、额外纹理坐标),这些自动生成的变量可能和你自定义的out_var_TEXCOORD6占用了相同的location或组件通道。比如某些复杂材质的节点会自动占用多个TEXCOORD槽位,刚好覆盖到TEXCOORD6。GLSL ES版本的兼容性限制
不同安卓设备的GLSL ES版本(如2.0/3.0)对纹理坐标(TEXCOORD)的最大支持数量不同,部分老设备可能仅支持最多8个TEXCOORD变量。当Unreal自动分配的变量加上你的自定义变量总数超过限制,或者编译器对变量位置的分配逻辑在低版本下出现重叠,就会触发冲突。变量组件的复用冲突
若out_var_TEXCOORD6的某个组件(如x/y/z/w)被其他变量绑定到同一个location的相同通道,也会触发该错误。比如两个变量都指定layout(location = 6) in vec2 var,本质上是共用了location6的xy组件,这种情况在手动拆分组件使用时容易出现。
排查建议
- 检查所有Shader代码中带
layout(location)的变量,确保每个location值唯一。 - 到项目
Saved/ShaderCache/Android目录下找到编译后的最终Shader代码,搜索out_var_TEXCOORD6和其他TEXCOORD变量的location分配情况,定位重复项。 - 尝试将自定义的
out_var_TEXCOORD6重命名为其他未被占用的TEXCOORD编号(如TEXCOORD7),验证是否解决冲突。 - 检查材质蓝图中是否使用了过多的纹理坐标输出节点,适当合并或减少不必要的TEXCOORD输出。
内容的提问来源于stack exchange,提问作者zichao liu

