攻克B站直播录制难题：DouyinLiveRecorder全方案解析

直播间地址正确却提示"未开播"？录制到一半突然中断？同一配置下其他平台正常唯独B站失败？本文将系统分析DouyinLiveRecorder项目中B站直播录制的常见问题，提供从配置检查到代码级修复的完整解决方案，让你轻松实现B站直播稳定录制。

问题定位：从现象到本质

B站直播录制失败通常表现为三种典型症状，每种症状对应不同的技术原因：

• 检测异常：明明正在直播却显示"未开播"，问题根源在main.py的状态判断逻辑。B站直播状态码通过json_data["status"]返回，当值为2时表示正在直播，但部分特殊直播间（如付费直播）会返回403错误导致状态误判。

• 录制中断：开始录制后几分钟内自动停止，这与B站的CDN防盗链机制密切相关。在stream.py的get_bilibili_stream_url函数中，未正确处理时效性token导致链接失效。

• 画质异常：录制文件只有音频没有视频，或分辨率与预期不符。这是由于B站提供的多种清晰度选项（原画10000、蓝光400、超清250等）在stream.py中映射关系错误。

解决方案：分层处理策略

1. 基础配置检查

首先通过三要素验证确保基础配置正确：

Cookie有效性
B站直播录制需要有效的登录Cookie，特别是对关注主播或付费内容。检查config/config.ini中的B站cookie配置项，确保包含SESSDATA和bili_jct字段：

[Cookie]
B站cookie = SESSDATA=xxxx; bili_jct=xxxx; DedeUserID=xxxx; DedeUserID__ckMd5=xxxx

获取方法：登录B站后，在浏览器开发者工具的Application→Cookies中复制。

代理设置
若访问境外B站资源，需在配置中启用代理：

[Proxy]
use_proxy = true
proxy_addr = 127.0.0.1:7890

确保代理支持HTTPS且能正常访问live.bilibili.com。

URL格式验证
确认URL符合README.md中的B站格式要求：

• 正确：https://live.bilibili.com/320（纯数字房间号）
• 错误：https://bilibili.com/video/xxxx（视频链接而非直播链接）

2. 高级参数调优

通过修改config/config.ini中的高级参数提升稳定性：

调整重试机制
增加网络错误重试次数和间隔时间：

[Network]
retry_count = 5
retry_interval = 3

设置录制格式
B站推荐使用TS格式避免文件损坏，在配置中修改：

[Record]
video_save_type = TS
split_video_by_time = true
split_time = 3600

TS格式支持断点续传，配合1小时自动分段，最大限度减少录制中断损失。

日志级别调整
开启详细日志便于问题排查：

[Log]
log_level = DEBUG
log_file = true

日志文件保存在logs/目录下，可通过logger.py配置输出格式。

3. 代码级修复

对核心模块进行针对性修改：

修复状态检测逻辑
在main.py中增强错误处理，当状态码异常时尝试备用API：

elif record_url.find("https://live.bilibili.com/") > -1:
    platform = 'B站直播'
    with semaphore:
        try:
            json_data = asyncio.run(spider.get_bilibili_room_info(
                url=record_url, proxy_addr=proxy_address, cookies=bili_cookie))
            # 增加状态码二次验证
            if json_data.get("status") not in [2, 1]:
                # 调用备用API获取真实状态
                json_data = asyncio.run(spider.get_bilibili_backup_info(record_url))
            port_info = asyncio.run(stream.get_bilibili_stream_url(
                json_data, video_quality=record_quality, cookies=bili_cookie, proxy_addr=proxy_address))
        except Exception as e:
            logger.error(f"B站直播信息获取失败: {str(e)}")
            error_count +=1

增强链接稳定性
修改stream.py的get_bilibili_stream_data函数，增加token自动刷新：

async def get_bilibili_stream_data(room_url, qn=10000, platform='web', proxy_addr=None, cookies=None):
    # ... 现有代码 ...
    # 添加token时效性检查
    if 'expires_in' in play_url_data:
        expire_time = time.time() + play_url_data['expires_in'] - 60  # 提前60秒刷新
        # 使用定时任务刷新token
        scheduler.add_job(refresh_bilibili_token, 'interval', seconds=play_url_data['expires_in']-120, 
                         args=[room_url, qn, platform, proxy_addr, cookies])
    return play_url

修正画质映射
在stream.py中修复清晰度参数映射：

video_quality_options = {
    "原画": '10000',  # 正确参数
    "蓝光": '400',    # 对应蓝光10M
    "超清": '250',    # 对应超清
    "高清": '150',    # 对应高清
    "标清": '80',     # 对应标清
    "流畅": '80'      # 最低画质
}

验证与监控

测试流程

1. 基础功能测试
   使用官方测试直播间https://live.bilibili.com/320（B站直播姬官方测试号）进行录制测试，观察日志输出：

2023-11-04 12:00:00 [INFO] B站直播检测: 正在直播
2023-11-04 12:00:02 [INFO] 获取流地址成功: https://xxx.m3u8
2023-11-04 12:00:03 [INFO] 开始录制: B站直播姬-20231104120003.ts

2. 稳定性测试
   连续录制至少2小时，检查是否出现中断或异常退出。正常情况下日志应持续输出：

2023-11-04 13:59:59 [INFO] 录制中: 已持续7199秒，文件大小1.2GB

3. 异常恢复测试
   故意断开网络30秒后恢复，验证程序是否能自动重连并继续录制。

状态监控

通过三种方式实时监控录制状态：

日志监控
定期检查logs/recorder.log文件，关键错误关键字：

• 403 Forbidden：Cookie失效或权限不足
• 404 Not Found：直播间不存在或已关闭
• Read timed out：网络问题或代理失效

进程监控
Linux系统可使用ps aux | grep ffmpeg查看录制进程，正常情况下每个直播间对应一个ffmpeg进程。

消息推送
配置config/config.ini中的消息推送功能，实时获取录制状态：

[MessagePush]
live_status_push = 钉钉,微信
dingtalk_api_url = https://oapi.dingtalk.com/robot/send?access_token=xxxx
xizhi_api_url = https://xizhi.qqoq.net/xxxx.send

常见问题FAQ

Q: 为什么录制的视频只有声音没有画面？
A: 这通常是由于选择了纯音频流。检查config/config.ini中的video_record_quality设置，确保未选择"纯音频"选项，并验证stream.py中的画质参数映射正确。

Q: 录制几分钟后自动停止，日志显示"Invalid data found when processing input"
A: B站CDN链接有时间限制，需在stream.py中实现token自动刷新机制。临时解决方案：降低config/config.ini中的split_time值，如设为300秒（5分钟）分段录制。

Q: 配置正确但提示"未开播"，实际直播间正在直播
A: 尝试在直播间URL后添加?is_room_feed=1参数，如https://live.bilibili.com/320?is_room_feed=1，并检查main.py中的状态判断逻辑是否正确处理该情况。

Q: Docker部署时B站录制失败，但本地运行正常
A: 检查Docker容器时间是否与主机同步，时区错误会导致Cookie时效判断异常。添加时区映射：

# docker-compose.yaml
environment:
  - TZ=Asia/Shanghai
volumes:
  - /etc/localtime:/etc/localtime:ro

总结与展望

通过本文介绍的配置优化和代码修复方案，可有效解决DouyinLiveRecorder项目中B站直播录制的常见问题。核心要点包括：确保Cookie有效性、正确处理B站的时效性token、修复画质参数映射关系。项目团队在最新提交中已针对B站直播做了专项优化，建议通过git pull更新代码至最新版本。

未来版本将进一步增强B站直播的稳定性，包括：多CDN节点自动切换、直播状态实时监控、异常自动恢复等功能。用户可通过README.md关注更新日志，或在项目Issues中反馈遇到的问题。

掌握这些技巧后，你不仅能解决B站直播录制问题，还能举一反三应用到其他平台的录制优化中，充分发挥DouyinLiveRecorder的多平台录制能力。