Flutter中JSON请求体特殊字符转义的最佳实践及存储方案问询

1. 是否应继续使用Uri.encodeFull()和Uri.decodeFull()？ #

不推荐。Uri.encodeFull()是为URL编码设计的，并非针对JSON字符串的转义需求——它会将空格、斜杠等URL敏感字符编码为%xx格式，不符合JSON的规范转义逻辑，后端处理时需要额外解码，容易引入不必要的复杂度和潜在bug。

正确的做法是使用Flutter内置的jsonEncode()单独处理字段值，再构造请求体：

// 示例：处理带特殊字符的用户输入
String rawInput = 'Hello "world"\n这是换行';
// 单独转义字段值
String encodedField = jsonEncode(rawInput);
// 构造请求体Map
Map<String, dynamic> requestData = {
  'user_content': encodedField,
};
// 对整个请求体编码后发送
String requestJson = jsonEncode(requestData);

后端Node.js收到请求后，先解析整个JSON，再对字段值执行JSON.parse()即可还原原始字符串：

// Node.js示例
const requestBody = JSON.parse(req.body);
const rawContent = JSON.parse(requestBody.user_content);

你之前用jsonEncode()出现异常，大概率是因为重复编码（比如先转义字段值，又对整个请求体重复编码），按上述步骤拆分处理即可避免。

2. 数据库应存储编码后的字符串还是解码后的原始字符串？ #

必须存储解码后的原始字符串。编码操作只是传输过程中为了兼容JSON解析的临时处理，存储原始内容有以下优势：

• 数据直观，便于后续维护、查询和调试
• 展示或二次使用时无需额外解码，减少不必要的计算步骤
• 避免因编码方式变更导致的数据解析失败风险

存储原始字符串后，后续从数据库读取时可直接用于展示（比如Flutter的TextField或富文本编辑器），无需额外处理。

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