卡死、没画面、没声音：OBS 日志排查指南，五步定位故障

卡死、没画面、没声音OBS 日志排查指南五步定位故障【免费下载链接】obs-studioOBS Studio - Free and open source software for live streaming and screen recording项目地址: https://gitcode.com/GitHub_Trending/ob/obs-studio昨晚直播卡死在第三十分钟录出来的文件还打不开——你的第一反应不该是骂电脑而是去翻 OBS 日志。开源直播与录屏软件 OBS Studio 会把从启动、加载设备到出错的每一步都写进 OBS 日志掌握了 OBS 日志查看和 OBS 问题排查绝大多数玄学故障能在 5 分钟内缩小到一两行报错。整个 OBS 调试工作流就五步找日志、认日志、搜关键字、验证修复、打包提交。第一步OBS 日志文件在哪里找日志查看器是内置的九成情况你根本不用碰文件路径。最快路径菜单栏帮助 → 查看日志当前运行的日志直接弹出来自动跳到最底部ERROR 是红色、WARNING 是橙色一眼就能扫出问题。查看器的全部实现都在 frontend/dialogs/OBSLogViewer.cpp 里配色逻辑说白了就是两行 HTML 字体标签的事。想看上一次运行尤其是崩溃后的那一次用同一个帮助菜单里的查看上次日志入口——它读的是已关闭的上一份文件不是正在写的那份。需要直接进目录的话系统日志存放路径Windows%APPDATA%\obs-studio\logsmacOS~/Library/Application Support/obs-studio/logsLinux~/.config/obs-studio/logs每次启动都会新建一个文件按启动时间命名形如obs-2025-08-28_20-30-15.txt按修改时间排序就能看到最新一份。这个目录来自 frontend/OBSApp.cpp 里对obs-studio/logs子目录的一次拼接白话解释OBS 先问系统要配置目录再挂上一个logs文件夹。还有一个容易漏掉的点崩溃时更有价值的材料是obs-studio/crashes目录下的崩溃转储帮助菜单里有直接打开该目录的入口。第二步如何看懂 OBS 日志四个级别速查四个日志级别里你真正要读的是 ERROR 和 WARNING其余是背景噪音。⚠️速查表如下级别枚举定义在 libobs/util/base.hLOG_ERROR 100, // 错误某件事真的失败了 LOG_WARNING 200, // 警告有隐患但程序还活着 LOG_INFO 300, // 信息正常操作记录 LOG_DEBUG 400 // 调试开发者细节默认关闭白话解释这里的编号是反着的ERROR 编号最小数字越大越不紧急——看到 400 的直接跳过。级别常见内容要不要圈INFO版本号、平台、图形后端、模块加载、码率开头扫一遍确认环境WARNING设备忙、资源不足、自行恢复的小毛病记个数成批出现就是信号ERROR打不开设备、连不上网络、建不出编码器逐条读DEBUG开发者级别的细节不用看日志里每一行报错都来自源码里类似这样的一行blog(LOG_ERROR, Failed to open device %s, name);白话解释日志行前面的文件名和行号就是这行语句的输出位置——排查的第一步就是确认这行话是哪个模块说的。真正值得圈的只有三类行开头的信息头版本、系统、平台、红色的 ERROR 行、崩溃前最后几秒的内容。第三步按故障类型走排查路线搜索会了排查就是搜关键字 → 看哪类报错 → 定方向的重复动作。 下面三类故障出现频率最高。3.1 推流中途断连搜什么RTMP、Connection、timeout看哪类报错红色 RTMP 连接 lost / failed 一行以及它前面紧挨着的编码器码率解决方向日志里设的码率明显超过上行带宽先降码率同一时间、同样报错反复出现换一个推流服务器或端口做对照断连时间和网络波动吻合就是网络的事不是 OBS 的事3.2 采集没有画面这种故障的现场预览窗口往往只剩一张占位图搜什么设备名本身或者采集后端名dshowWindows/v4l2Linux看哪类报错failed to open、device busy 一类的红字解决方向摄像头/显示器被别的程序会议软件、其他直播工具占用最常见先关掉它们权限类问题给相机、显示器权限后重启 OBS设备刚插拔过看日志里设备名有没有变3.3 声音缺失搜什么audio、mic或音频后端名wasapi/pulse/jack看哪类报错failed to open audio device或启动时压根没有音频源加载的那行解决方向默认录音设备变了耳机插拔最常见重新选设备采样率和输出对不上改到一致设备被其他程序独占关掉它第四步调试日志开关与日志清理真正常用的开关其实只有一个清理也只是删一个文件夹。启动时显示日志在日志查看器里勾选对应选项它会写进全局配置文件[LogViewer] ShowLogStartuptrue白话解释之后每次启动 OBS 先弹日志窗口错误一发生就看得见适合抓点下录制就出事这类问题。关于调试日志DEBUG 级别的输出只在开发构建里激活默认是关的普通用户不必强开。日志不够看的时候正确的下一步是看崩溃转储而不是把日志音量拧到最大。清理logs 目录从不自带轮转删除跑一次多一个文件。旧obs-*.txt可以放心删留最近三五份做对比crashes目录在崩溃包提交完以后清掉即可。第五步提交 issue 前把日志整理成开发者能用的材料日志打包得好开发者复现问题的速度直接快一倍。提交前一次性备齐四样故障时点的日志文件程序还活着就取当前日志崩溃过就取上次日志崩溃文件crashes目录里的内容有崩溃的话一句话信息OBS 版本 操作系统 两三步复现步骤 期望与实际结果打码日志里若含推流地址、账号信息发送前先抹掉不要把整份日志贴进正文——附上文件正文只引用关键几行。帮助菜单还内置了日志上传入口对应 frontend/dialogs/LogUploadDialog.cpp可以直接生成链接但同样要先打码。收尾从今天起就三件事出故障先帮助 → 查看日志把红字圈出来留档每月清一次 logs 目录的旧文件提交 issue 时版本、步骤、日志一次给全。做到这三点九成OBS 坏了都能在求助别人之前自己解决。【免费下载链接】obs-studioOBS Studio - Free and open source software for live streaming and screen recording项目地址: https://gitcode.com/GitHub_Trending/ob/obs-studio创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考