douyin-downloader 只能下载 20 条Cookie 失效快速排查完整指南【免费下载链接】douyin-downloaderA practical Douyin downloader for both single-item and profile batch downloads, with progress display, retries, SQLite deduplication, and browser fallback support. 抖音批量下载工具去水印支持视频、图集、合集、音乐(原声)。项目地址: https://gitcode.com/GitHub_Trending/do/douyin-downloader抖音批量下载工具 douyin-downloader 的下载异常归为四类只能抓到约 20 条、登录态失效 0 条、同一作品不再重复下载、transcript 文件未生成。修复思路查日志定因再重抓 cookie、启用浏览器兜底或清理数据库与本地文件的双重数据然后重跑验证。区分四类下不动现象判断要不要动手看起来一样的症状分属四种不同的问题域对着现象判断即可只抓到约 20 条就停无报错 → 翻页风控平台侧限流走「如何启用浏览器兜底」。输出 0 条或日志出现2483、请先登录 → 服务端登录态失效走「如何重新获取 Cookie」。重跑后同一作品不再下载 → 不是故障。程序用「数据库记录 本地文件」双重检查决定跳过属预期行为走「如何强制重新下载」。进度输出嘈杂、重复刷屏 → 不是故障是默认静默模式的表现无需修复见「特殊现象」。以上分诊依据 README.md 的常见问题与重新下载章节。如何检查是风控、登录失效还是去重 两步定因。第一步看日志区分风控与登录失效。运行下面的命令这条命令验证本次运行日志里是否存在登录态失效标记python run.py -c config.yml -v日志出现2483或请先登录 → 登录态失效走「如何重新获取 Cookie」一步。约 20 条后自动停止、无报错 → 翻页风控走「如何启用浏览器兜底」一步。两者都没有且下载正常完成 → 问题出在重复下载侧做第二步。第二步查数据库历史区分跳过与重下。运行下面的命令这条命令查询下载历史库最近 20 条记录验证作品是否已存在sqlite3 dy_downloader.db SELECT aweme_id, title, author_name, datetime(download_time, unixepoch, localtime) FROM aweme ORDER BY download_time DESC LIMIT 20;有记录且本地目录存在对应文件 → 程序判定已下载并跳过属设计内去重走「如何强制重新下载」。有记录但本地无文件 → 程序视为需要重新下载会自动重试无需操作README 原文 Note 的说法。无记录 → 该作品从未成功下载过回到第一步复查风控或登录失效。如何重新获取 Cookie 并启用浏览器兜底如何重新获取 Cookie修复登录态失效自动方式推荐运行下面的命令这条命令打开浏览器引导登录抖音登录完成后回到终端按 Entercookie 会自动写回config.ymlpython -m tools.cookie_fetcher --config config.yml这是 README 常见问题中「Cookie 失效怎么办」的标准答案。独立验证重跑原命令日志不再出现2483→ 修好。新版另有自动重登运行中遇到2483会自动打开浏览器引导登录抓到新 cookie 后自动重试一次重登后仍失败则明确报错中止不做无限重试。检测落点在 core/api_client.py错误处理矩阵见设计文档。手动方式Playwright 未安装或当前环境开不了浏览器时手动把浏览器里的 cookie 更新到config/cookies.json或config.yml的cookies段后重跑抓取实现可深挖 tools/cookie_fetcher.py。平台差异CI 或--serve模式这类非交互环境不会自动开浏览器程序会打印请手动更新 cookie并中止此时到交互终端手动重抓一次再复制回去即可。如何启用浏览器兜底修复只能 20 条修改config.yml这段配置验证浏览器兜底是否开启、浏览器是否可见手动过验证需要可见窗口browser_fallback: enabled: true headless: false重跑下载命令。翻页受限时程序自动打开浏览器在弹窗里手动完成验证不要立即关闭窗口。验证验证完成后下载数能越过 20 条 → 修好。注意浏览器兜底目前只对post模式完整生效like/mix/music仍依赖 API 翻页README 的 Current Limitations 章节。如何强制重新下载已下载的内容程序按「数据库记录 本地文件」双重检查决定是否跳过README.zh-CN.md 的重新下载章节强制重下需按范围清理重下特定作品下面两条命令删除该作品的本地文件与数据库记录rm -rf Downloaded/AuthorName/post/*_aweme_id/ sqlite3 dy_downloader.db DELETE FROM aweme WHERE aweme_id aweme_id;重下某作者全部作品下面命令删除该作者目录与全部记录rm -rf Downloaded/AuthorName/ sqlite3 dy_downloader.db DELETE FROM aweme WHERE author_name AuthorName;全部重置下面命令删除下载目录与历史库rm -rf Downloaded/ rm dy_downloader.db双重规则README 原文只删数据库不删文件不会触发重新下载——程序扫描本地文件名中的aweme_id去重只删文件不删数据库会触发重新下载。清理后重跑同一条命令作品再次出现在输出中 → 成功。验证下载状态是否恢复✅ 重跑原命令闭环风控类下载数量越过 20 条不再提前停止。登录失效类日志不再出现2483输出正常。重下类用上面的历史查询命令预期输出是该作品的download_time更新为本次运行时间桌面版用户可在任务中心直接查看任务结果、对失败项点重试并打开输出目录仍未恢复时按症状回退分类仍只有 20 条 → 回风控类确认headless: false且手动验证已完成仍2483→ 回登录失效类确认新 cookie 确实写入了配置文件仍被跳过 → 确认文件与数据库记录都删了两者任一存在即会跳过。特殊现象按序检查无需修复transcript 文件为什么没有生成属于配置与范围问题不是下载失败。按 README 常见问题 4 的顺序检查transcript.enabled是否为true下载的是否视频图文不转写设计限制OPENAI_API_KEY或transcript.api_key是否有效response_formats是否包含txt或json。进度条为什么重复刷屏不是故障。默认progress.quiet_logs: true会在进度阶段静默日志输出看起来乱时检查配置里该项是否为true调试时临时加--show-warnings或-v查看详细日志README 常见问题 2。核心修复链路查日志定因2483→ 登录失效 / 20 条即停 → 风控 / 被跳过 → 去重→ 重抓 cookie、启用浏览器兜底或清理数据库与文件双重数据 → 重跑用目录文件与数据库历史验证。【免费下载链接】douyin-downloaderA practical Douyin downloader for both single-item and profile batch downloads, with progress display, retries, SQLite deduplication, and browser fallback support. 抖音批量下载工具去水印支持视频、图集、合集、音乐(原声)。项目地址: https://gitcode.com/GitHub_Trending/do/douyin-downloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
