rank_backend/docs/定时任务配置说明.md

抖音播放量自动更新定时任务配置说明

概述

本文档详细说明如何配置Windows任务计划程序，实现每天晚上24:00（凌晨0点）自动运行抖音播放量抓取脚本。

前置条件

1. 确保MongoDB服务已安装并配置为自动启动

• 下载并安装MongoDB Community Server
• 配置MongoDB服务为自动启动：

  sc config MongoDB start= auto
  

2. 确保Python环境正确

• Python 3.7+ 已安装
• 所需依赖包已安装：

  pip install selenium pymongo webdriver-manager
  

3. 浏览器登录状态保持

• 重要：首次运行前，需要手动运行脚本并登录抖音账号
• 登录后，浏览器会保存登录状态到 chrome_profile 目录
• 自动模式将使用已保存的登录状态

配置步骤

步骤1：创建日志目录

在脚本目录下创建 logs 文件夹：

mkdir c:\Users\EDY\Desktop\test\logs

步骤2：测试批处理脚本

手动运行批处理脚本测试：

cd c:\Users\EDY\Desktop\test
auto_update_douyin.bat

步骤3：打开任务计划程序

1. 按 Win + R，输入 taskschd.msc，回车
2. 或者在开始菜单搜索"任务计划程序"

步骤4：创建基本任务

1. 在右侧操作面板点击"创建基本任务"
2. 输入任务名称：抖音播放量自动更新
3. 输入描述：每天凌晨0点自动抓取抖音收藏合集播放量数据

步骤5：设置触发器

1. 选择"每天"
2. 设置开始时间：22:00:00（晚上10点）
3. 设置开始日期：选择明天的日期
4. 重复间隔：每 1 天

步骤6：设置操作

1. 选择"启动程序"
2. 程序或脚本：c:\Users\EDY\Desktop\test\auto_update_douyin.bat
3. 添加参数：--silent
4. 起始于：c:\Users\EDY\Desktop\test

步骤7：高级设置

1. 勾选"如果任务失败，重新启动"
2. 设置重新启动间隔：5分钟
3. 设置重新启动次数：3次
4. 勾选"如果请求后任务还在运行，强行将其停止"
5. 设置停止任务时间：2小时

步骤8：条件设置

1. 取消勾选"只有在计算机使用交流电源时才启动此任务"
2. 勾选"唤醒计算机运行此任务"
3. 勾选"如果任务运行时间超过以下时间，则停止任务：2小时"

文件结构

c:\Users\EDY\Desktop\test\
├── douyin_playcount_scraper.py     # 主抓取脚本
├── auto_update_douyin.bat          # 批处理启动脚本
├── query_mongodb_data.py           # 数据查询脚本
├── chrome_profile\                 # 浏览器配置文件目录
├── logs\                          # 日志文件目录
│   ├── auto_update_20241215.log   # 每日日志文件
│   └── ...
├── douyin_collection_data.json     # JSON数据文件
├── douyin_collection_playcounts.txt # TXT格式数据文件
└── 定时任务配置说明.md             # 本说明文档

日志文件说明

日志位置

• 批处理日志：logs\auto_update_YYYYMMDD.log
• Python程序日志：同一文件，包含详细的执行信息

日志内容

• 任务开始和结束时间
• MongoDB连接状态
• 数据抓取进度
• 文件保存结果
• 错误信息（如有）

数据存储说明

MongoDB数据结构

{
  "batch_id": "20241215_000000_abc123",
  "batch_time": "2024-12-15 00:00:00",
  "name": "剧本名称",
  "playcount": "1.2万",
  "playcount_raw": 12000
}

数据特点

• 每次运行生成新的批次ID
• 最新数据排在前面（按时间倒序）
• 历史数据完整保留
• 支持按剧本名称搜索历史数据

故障排除

常见问题

1. MongoDB连接失败

症状：日志显示"MongoDB连接失败" 解决方案：

# 检查MongoDB服务状态
sc query MongoDB

# 启动MongoDB服务
net start MongoDB

2. 浏览器登录失效

症状：抓取失败，提示需要登录 解决方案：

1. 手动运行脚本：python douyin_playcount_scraper.py
2. 重新登录抖音账号
3. 登录状态会自动保存到 chrome_profile 目录

3. Python环境问题

症状：批处理脚本报错"Python未安装" 解决方案：

1. 确认Python已安装：python --version
2. 确认Python在系统PATH中
3. 重新安装依赖：pip install -r requirements.txt

4. 权限问题

症状：任务计划程序无法执行 解决方案：

1. 以管理员身份运行任务计划程序
2. 设置任务以最高权限运行
3. 确保用户账户有足够权限

监控和维护

查看任务执行历史

1. 打开任务计划程序
2. 找到"抖音播放量自动更新"任务
3. 查看"历史记录"选项卡

查看数据抓取结果

运行查询脚本：

python query_mongodb_data.py

手动测试

定期手动运行测试：

python douyin_playcount_scraper.py --auto-mode

注意事项

1. 网络连接：确保计算机在凌晨0点时有稳定的网络连接
2. 电源管理：建议设置计算机不要在夜间自动休眠
3. 防火墙：确保防火墙不会阻止浏览器和MongoDB的网络访问
4. 磁盘空间：定期清理旧的日志文件，避免占用过多磁盘空间
5. 数据备份：建议定期备份MongoDB数据库

联系支持

如遇到问题，请检查：

1. 日志文件中的错误信息
2. 任务计划程序的执行历史
3. MongoDB服务状态
4. 网络连接状态