Files
dysync/docs/数据库检查说明.md
T
yuming ad97fd3da5 整理仓库:扩展 gitignore、归档文档、清理冗余 Dockerfile
- .gitignore 新增忽略 .idea/、videos/、*.tar.gz、*.csproj.user、db 运行时文件
- 根目录 15 个中文运维 md 归档到 docs/
- 删除无部署脚本引用的 Dockerfile 与 Dockerfile-arm(保留 Dockerfile.prod)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-24 21:28:41 +08:00

154 lines
4.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 数据库检查说明
由于终端命令执行环境问题,我为您提供以下检查方法:
## 🔍 检查方法
### 方法一:通过前端页面检查(推荐)
1. **访问前端页面**: `http://localhost:8001`
2. **登录系统**: 用户名 `douyin` / 密码 `douyin2025`
3. **查看数据看板**: 点击「数据看板」查看视频统计
- 视频总数
- 作者数量
- 分类数量
- 存储空间统计
4. **查看同步记录**: 点击「同步记录」查看视频列表
- 查看是否有视频记录
- 检查视频是否有 `videoSavePath` 字段
### 方法二:通过 Swagger API 检查
1. **访问 Swagger**: `http://localhost:10101/swagger`
2. **测试统计接口**:
- 找到 `GET /api/video/statics`
- 点击 "Try it out" → "Execute"
- 查看返回的视频统计数据
3. **测试分页查询接口**:
- 找到 `POST /api/video/paged`
- 点击 "Try it out"
- 输入参数: `{"pageIndex":1,"pageSize":10}`
- 点击 "Execute"
- 查看返回的视频列表
### 方法三:手动执行 SQL 查询
在终端中执行以下命令:
```bash
cd /Users/gaotu/WebstormProjects/dysync.net
# 1. 查看视频总数
sqlite3 db/dy.sqlite "SELECT COUNT(*) FROM dy_collect_video;"
# 2. 查看有保存路径的视频数量
sqlite3 db/dy.sqlite "SELECT COUNT(*) FROM dy_collect_video WHERE videoSavePath IS NOT NULL AND videoSavePath != '';"
# 3. 查看 Cookie 配置
sqlite3 -header -column db/dy.sqlite "SELECT id, userName, savePath, favSavePath, uperSavePath FROM dy_user_cookies;"
# 4. 查看视频记录示例
sqlite3 -header -column db/dy.sqlite "SELECT id, videoTitle, author, videoSavePath, fileSize FROM dy_collect_video LIMIT 5;"
# 5. 检查视频文件是否存在(示例)
sqlite3 db/dy.sqlite "SELECT videoSavePath FROM dy_collect_video WHERE videoSavePath IS NOT NULL LIMIT 1;" | xargs -I {} test -f {} && echo "文件存在" || echo "文件不存在"
```
## 📋 检查清单
### ✅ Cookie 配置检查
- [ ] Cookie 是否已配置?
- [ ] `savePath`(收藏视频路径)是否已设置?
- [ ] `favSavePath`(喜欢视频路径)是否已设置?
- [ ] `uperSavePath`(博主视频路径)是否已设置?
- [ ] Cookie 内容是否有效(长度 > 1000)?
### ✅ 视频数据检查
- [ ] 数据库中是否有视频记录?
- [ ] 视频记录是否有 `videoSavePath` 字段?
- [ ] 视频文件是否实际存在于文件系统中?
- [ ] 视频文件大小是否正常?
### ✅ 同步任务检查
- [ ] 定时任务是否已启动?
- [ ] 最近是否有同步日志?
- [ ] 同步是否成功完成?
## 🐛 常见问题
### 1. 数据库中没有视频记录
**可能原因**:
- Cookie 未配置或无效
- 保存路径未配置
- 同步任务未执行
- 同步任务执行失败
**解决方法**:
1. 检查「抖音授权」页面,确保 Cookie 和路径已配置
2. 点击「立即重新同步」手动触发同步
3. 查看系统日志了解同步失败原因
### 2. 有记录但没有 videoSavePath
**可能原因**:
- 视频下载失败
- 保存路径配置错误
- 文件系统权限问题
**解决方法**:
1. 检查保存路径配置是否正确
2. 检查文件系统权限
3. 查看日志了解下载失败原因
### 3. 有 videoSavePath 但文件不存在
**可能原因**:
- 文件被删除
- 路径配置错误
- 文件系统路径映射问题
**解决方法**:
1. 检查文件路径是否正确
2. 检查文件是否被删除
3. 重新同步视频
## 📝 下一步操作
1. **如果数据库为空**:
- 配置 Cookie 和保存路径
- 手动触发同步任务
- 等待同步完成
2. **如果有数据但无 videoSavePath**:
- 检查保存路径配置
- 重新同步视频
3. **如果有 videoSavePath 但文件不存在**:
- 检查文件路径
- 重新同步视频
4. **如果一切正常**:
- 测试视频预览功能
- 点击「预览」按钮查看视频
## 🔧 手动触发同步
在前端页面:
1. 进入「同步记录」页面
2. 点击「立即重新同步」按钮
3. 等待同步完成(查看日志)
或通过 API:
```bash
curl http://localhost:10101/api/config/ExecuteJobNow
```
---
**提示**: 如果遇到问题,请查看 `logs/` 目录下的日志文件了解详细信息。