dysync/docs/数据库检查说明.md

数据库检查说明

由于终端命令执行环境问题，我为您提供以下检查方法：

🔍 检查方法

方法一：通过前端页面检查（推荐）

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 查询

在终端中执行以下命令：

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：

curl http://localhost:10101/api/config/ExecuteJobNow

---

提示: 如果遇到问题，请查看 logs/ 目录下的日志文件了解详细信息。