Node.js环境下Avro Schema定义联合类型时抛出无效值类型错误

看起来你遇到了一个挺棘手的问题——相同的Avro Schema在Python里正常工作，但用SWC编译的Node.js环境中，联合类型["null", "string"]的验证却失败了。我帮你分析下可能的原因和解决方案：

核心原因推测 #

avro-js库在解析联合类型时，对原生数组的格式有严格要求，而SWC的默认编译优化可能会修改数组的结构（比如冻结数组、添加额外属性），导致库无法正确识别这是一个合法的联合类型定义。

具体解决方案 #

1. 检查并调整SWC编译配置 #

首先查看dist/testSchema.js的编译输出，确认联合类型数组是否被篡改。如果发现数组变成了Object.freeze(["null", "string"])这类形式，就需要修改SWC配置来禁用相关优化。

在项目根目录创建或修改.swcrc文件，添加以下配置：

{
  "jsc": {
    "parser": {
      "syntax": "ecmascript"
    },
    "transform": {
      "optimizer": {
        "globals": {
          "vars": {}
        },
        "simplify": false
      }
    },
    "target": "es2020"
  },
  "module": {
    "type": "es6"
  }
}

这个配置会关闭不必要的代码简化优化，确保编译后的数组保持原生结构，让avro-js能正确识别。

2. 直接使用avro-js的Union类型定义 #

如果调整SWC配置后还是有问题，可以绕过原生数组，直接用avro-js提供的Union构造函数来定义联合类型：

修改testSchema.js：

import avro from 'avro-js';

export default {
  name: 'Pet',
  type: 'record',
  fields: [
    {name: 'name', type: 'string'},
    {name: 'animal', type: avro.Union(['null', 'string'])}
  ]
}

这种方式直接生成avro-js内部能识别的联合类型对象，彻底避免了编译带来的数组结构问题。

3. 降级avro-js版本测试 #

你当前使用的avro-js@1.11.0可能存在和SWC的兼容性问题，尝试降级到更稳定的1.10.0版本：

npm uninstall avro-js
npm install avro-js@1.10.0

4. 跳过SWC验证问题根源 #

临时修改dev脚本，直接运行未编译的代码：

"dev": "nodemon src/index.js"

如果此时验证通过，就能100%确定是SWC编译导致的问题，再集中精力调整SWC配置即可。

验证修改效果 #

修改后重新运行你的代码，检查isValid的返回值：

import avro from 'avro-js'
import testSchema from './testSchema.js'

const testSchemaAvro = avro.parse(testSchema)
const testObject = {"name": "Val", "animal": "cat"}
const isValid = testSchemaAvro.isValid(testObject, {
  errorHook(path, any, type) {
    console.error(`'${any}' is not a valid value (of type ${type}) for '${path.join(".")}'`)
  }
})
console.log('验证结果:', isValid) // 正常情况下应该输出true

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