解决New-API项目中Midjourney绘图任务中文提示入库失败问题

问题现象分析

在New-API项目运行过程中，当用户通过Midjourney代理提交包含中文提示词（如"美女秃头"）的绘图任务时，系统虽然能成功提交到Discord并返回任务ID（1726686177195433），但在数据库记录环节出现异常。日志显示MySQL报错"Incorrect string value"，表明数据库无法正确处理中文字符。

根本原因定位

该问题的核心在于MySQL数据库表的字符编码配置不完善。具体表现为：

1. 数据库表的prompt字段使用的字符集（如latin1）不支持存储中文字符
2. 当系统尝试插入包含中文的提示词时，MySQL抛出错误代码1366
3. 虽然业务逻辑已执行（任务已提交到Discord），但数据持久化失败导致API返回400错误

解决方案

短期应急方案

1. 临时修改提交内容为英文提示词
2. 在应用层对中文进行Base64编码后再存储

根本解决方案

1. 修改MySQL表结构，将相关字段字符集改为utf8mb4：

   ALTER TABLE midjourneys MODIFY prompt VARCHAR(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
   

2. 检查数据库连接配置，确保连接层也使用utf8mb4字符集
3. 对于已有数据，需要进行字符集转换和迁移

技术延伸

utf8mb4的重要性

MySQL的utf8mb4字符集是存储多语言内容的推荐选择，相比传统utf8具有以下优势：

• 完整支持Unicode字符（包括emoji）
• 支持四字节的中文字符
• 是现代MySQL版本的默认字符集

数据库设计最佳实践

1. 新建表时显式指定字符集：

   CREATE TABLE example (
     content TEXT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci
   ) DEFAULT CHARSET=utf8mb4;
   

2. 统一数据库、表和连接三个层面的字符集配置
3. 对于国际化项目，应在设计初期就考虑多语言支持

问题预防

1. 在CI/CD流程中加入数据库schema检查
2. 实现自动化测试覆盖多语言场景
3. 在应用层增加字符集验证逻辑
4. 建立数据库变更评审机制，确保字符集等基础配置正确

总结

字符编码问题是分布式系统中常见的兼容性问题，特别是在处理用户生成内容时。通过本次问题的解决，我们不仅修复了当前的功能缺陷，更重要的是建立了预防类似问题的长效机制，为系统的国际化支持奠定了坚实基础。