如何在Next.js项目中向Postgres批量插入含特殊字符的Markdown数据

方案1：使用参数化查询（最推荐） #

这是最安全、无需手动处理转义的方案，Next.js生态常用的Postgres客户端（包括pg库、Prisma、Drizzle ORM等）都原生支持参数化查询能力，数据库驱动会自动完成特殊字符转义、JSON类型适配，完全不需要你手动处理Markdown里的特殊符号。

示例（使用pg库）：

import { Pool } from 'pg';
const pool = new Pool({
  // 你的Postgres连接配置
});

// 原始数据，直接保留所有Markdown内容、特殊字符即可，不需要额外处理
const insertData = {
  author: "xxx",
  createTime: Date.now(),
  markdownContent: `包含大量特殊字符的Markdown内容："r"i""n$'t\u0066`
};

// 用占位符传参，直接传入JS对象即可，驱动自动处理转义和类型转换
await pool.query(
  'INSERT INTO docs (content) VALUES ($1)',
  [insertData]
);

如果使用ORM，操作更简单，直接给JSON字段赋值JS对象即可，框架会自动完成所有适配工作。

方案2：JSON序列化+显式类型转换（适配特殊场景） #

如果因为业务需求需要手动处理JSON字符串，可以先在业务代码中用JSON.stringify()将待插入的JS对象转为标准JSON字符串，再配合Postgres的::JSONB类型转换语法结合参数化查询使用，同样不会出现格式错误：

// 先序列化得到标准JSON字符串
const jsonString = JSON.stringify(insertData);

// 显式指定类型转换后插入
await pool.query(
  'INSERT INTO docs (content) VALUES ($1::JSONB)',
  [jsonString]
);

方案3：字段拆分存储（可选优化） #

如果你的数据中Markdown内容占比极高，且日常查询不需要在JSON内部检索Markdown字段，可以拆分字段存储：将Markdown内容单独存入TEXT类型字段，其余结构化元数据存入JSONB字段。TEXT类型对所有特殊字符原生兼容，不需要任何转义处理，读写性能也比存储在JSON内部更高。

避坑提醒 #

• 禁止直接拼接SQL字符串插入JSON内容，既会出现特殊字符导致的语法错误，也存在SQL注入风险
• 不需要手动处理Markdown内部的转义字符，JSON.stringify()和数据库驱动会自动完成标准化处理
• 优先选用Postgres的JSONB类型而非JSON类型，后者仅做原始字符串存储不支持索引和内部检索，性能更差

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