WebGL 贴图宽度是3像素就上传失败，怎样检查 UNPACK_ALIGNMENT

先按纹理格式计算每行字节数，再核对 UNPACK_ALIGNMENT。WebGL1 默认按4字节对齐，3像素宽 RGB 每行9字节的紧密数组可能不满足默认行跨度；显式改为1后再上传，并检查 getError。

把行跨度和总长度算出来

附件建立3×2的RGB无符号字节纹理，紧密数据共18字节。alignment为4时每行起点按4字节边界推进，前一行9字节后有填充需求；最后一行不一定需要补满，但总输入仍至少21字节。紧密18字节不足，因此默认组预期INVALID_OPERATION，数值1282；alignment改1后每行恰好9字节，上传应无错误。

先确认格式再套计算

RGBA四通道常让常见宽度自然满足4字节边界，所以问题可能只在RGB、小尺寸或其他数据格式出现。不能一看到3像素宽就断言所有纹理都需要改对齐，实际字节数还取决于format、type和数据来源。这个例子明确使用WebGL1、RGB、UNSIGNED_BYTE与TypedArray，不测试HTMLImageElement等来源的转换路径。

检查错误要靠近调用位置

程序在每次texImage2D后立即getError，避免旧错误积压后误归到下一步。没有绘制画面也能验证上传参数边界；纹理能上传不代表能被采样，因为过滤和环绕完整性还有独立限制。真实工程应分别记录纹理尺寸、格式、数组长度和对齐值，别只留下一个“贴图黑了”的截图。

状态不会因换纹理自动复位

pixelStorei设置属于上下文状态，后续上传也会受影响。库与自写代码共用context时，要约定是否恢复原值或在每次上传前明确设置。附件使用ANGLE SwiftShader软件后端，并记录版本与renderer，不据此比较实体GPU吞吐。目标浏览器、驱动与WebGL2需另验，本题不处理glTF资产布局或文件容器字节结构。

区分读取对齐与上传对齐

UNPACK_ALIGNMENT用于从源数据上传，PACK_ALIGNMENT涉及读取回数据时的布局，两者不能混为一个全局对齐开关。本例只改UNPACK并检查RGB上传，readPixels的其他格式与缓冲长度没有在此测试。若项目同时使用截图、纹理读回或异步处理，应分别记录各自参数和目标数组尺寸，不要把上传成功的18字节结论复制到另一个读回路径。

下载并复现

下载原创HTML夹具、独立验证程序、本次执行记录和依赖与运行说明，放在同一目录。安装Playwright 1.58.0及其Chromium后运行 python verify.py；程序使用两个随机本地端口，自动关闭浏览器与服务，不请求外网或业务接口。

本次实际环境为Python 3.12.4、Playwright 1.58.0、Chromium 145.0.7632.6。Canvas2D或WebGL1页面API与像素读取；非指针输入、非实体GPU性能测量。断言已通过；完整事件和数值保留在执行记录，不能把它改名后当目标展项测量。

Canvas题限定2D上下文，WebGL题限定WebGL1；启动使用ANGLE SwiftShader软件后端参数，实际renderer可见对应执行记录。软件后端的像素结果不代表实体显卡性能、驱动稳定性或跨浏览器一致性。

继续核查与一级出处

基础背景见互动引擎怎么选？雷达/体感/触摸触发方式对比与选型清单。上传字节布局正确之外，采样参数仍可能使纹理不完整，可继续用WebGL 小图贴上去全黑，怎样核对非二次幂纹理的采样完整性取证；相关工程入口在专题与产品对接说明。

• WebGL1 pixelStorei的UNPACK_ALIGNMENT与像素数据大小要求：2026-10-24已联网读取一级来源；WebGL 1.0.3，2014-10-27；不把latest编辑草案当定稿。