Ubuntu系统中cv2.VideoCapture报错“unable to stop the stream”求助

我来帮你排查这个问题——你已经把代码简化到只剩两行还报这个错，说明问题大概率出在视频文件本身、OpenCV的编解码器支持，或者VideoCapture的初始化逻辑上。咱们一步步来解决：

1. 先确认视频文件是否正常 #

• 用Ubuntu自带的VLC播放器直接打开test.avi，看看能不能正常播放。如果播放失败，那就是文件损坏、格式不兼容，直接换一个正常的视频文件测试就行。
• 如果能正常播放，那问题就聚焦在OpenCV的解码能力上了。

2. 检查OpenCV的编解码器支持 #

OpenCV依赖FFmpeg等库来解码视频文件，很多时候这个报错是因为OpenCV没编译FFmpeg支持：

• 在终端运行以下命令，查看OpenCV的编译配置：

  opencv_version --verbose
  

  找输出里有没有FFmpeg: YES相关的条目。如果没有，说明你的OpenCV缺失FFmpeg支持，需要：
  • 要么用系统包管理器安装带FFmpeg的OpenCV：

    sudo apt update && sudo apt install libopencv-videoio-dev ffmpeg
    

  • 要么重新编译OpenCV，编译时记得启用FFmpeg选项（CMake配置里勾选WITH_FFMPEG）。

3. 手动指定VideoCapture后端 #

有时候OpenCV默认的视频后端不兼容你的AVI文件，可以强制指定FFmpeg或GStreamer后端试试：

import cv2

# 尝试用FFmpeg后端打开视频
cap = cv2.VideoCapture('test.avi', cv2.CAP_FFMPEG)

# 检查是否成功打开
if not cap.isOpened():
    print("无法打开视频文件，请检查路径或编解码器")

另外，建议用绝对路径替换相对路径（比如/home/your_username/test.avi），避免因工作目录问题导致的隐性错误。

4. 转换视频编码格式 #

如果视频用了OpenCV不支持的小众编码，也会触发这个错误：

• 先用ffprobe查看视频编码：

  ffprobe -v error -select_streams v:0 -show_entries stream=codec_name -of default=noprint_wrappers=1:nokey=1 test.avi
  

• 如果编码不是常见的mpeg4、h264等，用FFmpeg转成通用格式：

  ffmpeg -i test.avi -c:v libx264 -crf 23 -c:a aac output.mp4
  

  然后用转好的output.mp4测试你的代码。

5. 验证VideoCapture本身是否正常 #

如果以上方法都不行，试试打开摄像头验证VideoCapture功能：

import cv2

# 打开默认摄像头（设备ID为0）
cap = cv2.VideoCapture(0)
if cap.isOpened():
    print("摄像头正常打开，说明VideoCapture功能没问题")
    cap.release()
else:
    print("摄像头也打不开，可能是OpenCV安装有问题")

内容的提问来源于stack exchange，提问作者Haoyu Chen