Memos MySQL附件存储报错？三招解决文件上传失败难题
项目地址: https://gitcode.com/GitHub_Trending/me/memos 你是否在使用Memos时遭遇过MySQL存储附件报错？文件上传失败、服务无响应甚至数据丢失，这些问题不仅打断创作思路，更可能导致重要资料损坏。本文将从代码实现到配置优化，提供一套完整解决方案，让你三分钟解决附件存储难题。
项目简介
Memos是一款开源轻量级笔记服务（Note-taking Service，笔记服务），支持快速捕捉和分享思想。其简洁的界面和强大的本地化存储能力深受用户喜爱。
核心存储模块位于store/db/mysql/目录，其中attachment.go负责处理MySQL附件存储逻辑。
问题现象与影响范围
附件上传失败通常表现为：
- 前端显示"网络错误"但控制台无4xx/5xx状态码
- 服务日志出现"packet for query is too large"错误
- 大于1MB的文件持续上传失败，小文件正常
这些问题根源在于MySQL默认配置与Memos存储逻辑的兼容性问题，主要影响使用Docker部署且采用MySQL作为存储后端的用户。
深度原因分析
1. MySQL数据包大小限制
MySQL默认max_allowed_packet参数值为4MB，当附件大小超过此限制时会触发截断错误。查看attachment.go的SQL插入逻辑：
stmt := "INSERT INTO `resource` (" + strings.Join(fields, ", ") + ") VALUES (" + strings.Join(placeholder, ", ") + ")"
result, err := d.db.ExecContext(ctx, stmt, args...)
if err != nil {
return nil, err
}
当create.Blob字段（存储文件二进制数据）超过限制时，ExecContext会返回数据包过大错误。
2. 数据库字段类型限制
在MySQL实现中，附件二进制数据存储于resource表的blob字段。标准BLOB类型最大支持65KB，远不能满足现代附件需求。查看store/db/mysql/attachment.go的CreateAttachment函数，未对大文件做分片处理。
3. Docker部署配置缺失
默认scripts/compose.yaml未配置MySQL环境变量，导致使用默认限制：
services:
memos:
image: neosmemo/memos:latest
container_name: memos
volumes:
- ~/.memos/:/var/opt/memos
ports:
- 5230:5230
分步解决方案
方案一：调整MySQL配置参数
- 修改MySQL配置文件增加以下参数：
[mysqld]
max_allowed_packet=64M
innodb_log_file_size=128M
- Docker部署用户需更新compose.yaml，添加MySQL服务配置：
services:
mysql:
environment:
- MYSQL_DATABASE=memos
- MYSQL_ROOT_PASSWORD=yourpassword
command: --max-allowed-packet=67108864
方案二：优化数据表结构
执行SQL修改字段类型为MEDIUMBLOB（支持16MB）或LONGBLOB（支持4GB）：
ALTER TABLE resource MODIFY COLUMN blob LONGBLOB;
此变更对应store/db/mysql/attachment.go中的blob字段定义。
方案三：实现分片存储逻辑
高级用户可修改附件处理逻辑，参考S3存储实现将大文件分片存储：
// 伪代码示例：大文件分片处理
func (d *DB) CreateAttachment(ctx context.Context, create *store.Attachment) (*store.Attachment, error) {
if create.Size > 10*1024*1024 { // 10MB以上分片
return d.createShardedAttachment(ctx, create)
}
// 原处理逻辑...
}
验证与测试
修改配置后，通过以下步骤验证：
- 上传10MB、30MB、50MB三个测试文件
- 检查store/db/mysql/attachment_filter_test.go中的测试用例
- 监控服务日志确认无
packet too large错误
预防措施
- 定期检查store/migration/mysql/LATEST.sql获取最新表结构
- 生产环境建议使用对象存储（S3/MinIO）替代数据库存储附件，配置参考plugin/storage/s3/
- 监控MySQL错误日志中
max_allowed_packet相关记录
总结
通过调整MySQL配置、优化表结构和实现分片存储三种方案，可彻底解决Memos附件存储报错问题。推荐普通用户优先采用方案一和方案二，高级用户可考虑对象存储方案。所有修改均基于项目现有代码结构，确保兼容性和可维护性。
遇到复杂问题可参考store/test/attachment_test.go的测试场景，或在项目GitHub Issues中搜索类似问题。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
