63 lines
1.6 KiB
Markdown
63 lines
1.6 KiB
Markdown
# 文章 base64 图片迁移脚本
|
||
|
||
将 `chapters` 表中 `content` 字段内嵌的 base64 图片提取为独立文件，并替换为 `/uploads/book-images/xxx` 的 URL，减小文章体积。
|
||
|
||
## 适用场景
|
||
|
||
- 历史文章中有大量粘贴的 base64 图片
|
||
- 保存时因 content 过大导致超时或失败
|
||
- 需要将 base64 转为文件存储
|
||
|
||
## 执行方式
|
||
|
||
### 1. 测试环境（建议先执行）
|
||
|
||
```bash
|
||
cd soul-api
|
||
|
||
# 加载测试环境配置（.env.development）
|
||
$env:APP_ENV="development"
|
||
|
||
# 先 dry-run 预览，不写入
|
||
go run ./cmd/migrate-base64-images --dry-run
|
||
|
||
# 确认无误后正式执行
|
||
go run ./cmd/migrate-base64-images
|
||
```
|
||
|
||
### 2. 生产环境
|
||
|
||
```bash
|
||
cd soul-api
|
||
$env:APP_ENV="production"
|
||
go run ./cmd/migrate-base64-images --dry-run # 先预览
|
||
go run ./cmd/migrate-base64-images # 正式执行
|
||
```
|
||
|
||
### 3. 指定 DSN（覆盖 .env）
|
||
|
||
```bash
|
||
$env:DB_DSN="user:pass@tcp(host:port)/db?charset=utf8mb4&parseTime=True"
|
||
go run ./cmd/migrate-base64-images --dry-run
|
||
```
|
||
|
||
## 参数
|
||
|
||
| 参数 | 说明 |
|
||
|------|------|
|
||
| `--dry-run` | 仅统计和预览，不写入文件与数据库 |
|
||
|
||
## 行为说明
|
||
|
||
1. 查询 `content LIKE '%data:image%'` 的章节
|
||
2. 用正则提取 `src="data:image/xxx;base64,..."` 或 `src='...'`
|
||
3. 解码 base64，保存到 `uploads/book-images/{timestamp}_{random}.{ext}`
|
||
4. 将 content 中的 base64 src 替换为 `/uploads/book-images/xxx`
|
||
5. 更新数据库
|
||
|
||
## 注意事项
|
||
|
||
- **务必先在测试环境验证**，确认无误后再跑生产
|
||
- 脚本依赖 `UPLOAD_DIR` 或默认 `uploads` 目录
|
||
- 图片格式支持：png、jpeg、jpg、gif、webp
|