Node.js+TypeORM+MySQL实体添加数组字段时出现语法错误

核心问题分析 #

从报错的SQL语句ALTER TABLE userADDfavorites text NOT NULL DEFAULT '能明显看到，DEFAULT后缺少合法闭合值，导致语法截断。原因是你给simple-array类型字段设置的默认值为[]，但TypeORM处理simple-array时会将数组转为逗号分隔的字符串，空数组[]被转换为空字符串后，生成SQL时未正确添加闭合引号，引发语法错误。

至于报错显示MariaDB：你使用的mysql2驱动对MySQL和MariaDB兼容性极强，驱动会返回数据库实际类型，可能你的运行环境实际是MariaDB，或是驱动识别逻辑导致显示差异，这不影响核心问题的解决。

解决方案 #

将字段default值从[]改为空字符串''，TypeORM会自动将空字符串转换为空数组：

@Column({ type: "simple-array", default: '' })
favorites: string[];

@Column({ type: "simple-array", default: '' })
cart: string[];

若需要默认包含元素的数组，直接写逗号分隔的字符串形式即可，比如默认['apple','banana']就设置default: 'apple,banana'。

补充说明 #

• simple-array类型本质是把数组序列化为逗号分隔的字符串存储在TEXT字段中，数据库层面存的是字符串，TypeORM会在读写时自动完成数组与字符串的转换。
• MySQL/MariaDB的TEXT类型允许设置默认值，但必须指定字符串常量，不能直接使用数组语法。

内容的提问来源于stack exchange，提问作者Josué Mendonça