BigQuery JavaScript UDF中位运算符未生效：字节数组操作异常

问题根源 #

BigQuery传入JS UDF的BYTES类型参数是不可变的Uint8Array视图，直接通过下标修改元素的操作不会实际生效。而Node.js里处理的Buffer是可变的TypedArray，所以位运算修改能正常生效——这就是两者结果不一致的核心原因。

你看到BigQuery返回原始MD5结果，正是因为那些位运算赋值被静默忽略了：不可变数组的元素赋值不会报错，但完全不会改变原数组内容，和你在Node里不执行位运算的结果一致。

修复方案 #

要在BigQuery里修改字节数组，必须先创建一个可变的副本，修改副本后再返回。用Uint8Array.from()复制原数组即可：

CREATE TEMP FUNCTION testHash(md5Bytes BYTES)
RETURNS BYTES 
LANGUAGE js AS """
// 先复制出可变的字节数组
const mutableBytes = Uint8Array.from(md5Bytes);
mutableBytes[6] &= 0x0f;
mutableBytes[6] |= 0x30;
mutableBytes[8] &= 0x3f;
mutableBytes[8] |= 0x80;
return mutableBytes;
""";

SELECT TO_HEX(testHash(MD5("test_phrase")));

执行这段代码后，就能得到和Node.js一致的预期结果：cb5012e39277348eb0b5c88bded48591

补充说明 #

BigQuery把输入参数设为不可变，是为了保证UDF的纯函数特性（相同输入一定返回相同输出），避免意外的副作用。而Node.js的Buffer设计为可变，是为了适配IO场景下的高效内存操作需求，两者设计目标不同才导致了这个差异。

内容的提问来源于stack exchange，提问作者user8811409