OpenCV灰度视频保存失败，报错“could not demultiplex stream”求解

这个问题我之前也碰到过，核心原因基本都是视频编码格式不兼容或者灰度视频的参数设置错误，导致视频文件没有正确写入完整的流信息，所以才会出现文件极小、播放器无法解析的情况。下面给你一步步的解决方案：

一、关键问题分析 #

你看到的"could not demultiplex stream"错误，本质是mplayer无法识别文件里的视频流结构——因为OpenCV没有成功把编码后的帧写入文件，大多是因为：

• 没有针对灰度单通道视频设置正确的参数
• 使用了当前平台不支持的Codec
• VideoWriter初始化失败但你没做检查

二、正确的灰度视频保存步骤 #

1. 选择兼容的Codec #

不同平台的默认Codec支持差异很大，推荐优先用MJPG编码，它对灰度视频的支持很好，跨平台兼容性也强：

• 在OpenCV中用cv2.VideoWriter_fourcc(*'MJPG')来指定编码
• 如果你用的是Linux，也可以试试XVID，但MJPG的容错性更高

2. 完整代码示例 #

下面是一个可以直接运行的灰度视频保存示例，注意几个关键点：

• 读取帧后要转成单通道灰度图（cv2.cvtColor(frame, cv2.COLOR_BGR2GRAY)）
• VideoWriter的参数要和灰度帧的尺寸、通道数匹配（灰度图是单通道，所以不需要额外指定通道，但要确保帧大小一致）
• 一定要检查VideoWriter是否初始化成功（返回值为True）

import cv2

# 打开摄像头或者读取视频文件
cap = cv2.VideoCapture(0)  # 0是默认摄像头，也可以替换成视频文件路径

# 获取原视频的帧宽高、帧率
frame_width = int(cap.get(cv2.CAP_PROP_FRAME_WIDTH))
frame_height = int(cap.get(cv2.CAP_PROP_FRAME_HEIGHT))
fps = int(cap.get(cv2.CAP_PROP_FPS))

# 设置VideoWriter：指定Codec、帧率、帧大小，明确为灰度模式
fourcc = cv2.VideoWriter_fourcc(*'MJPG')
# 注意最后一个参数isColor=False，必须设置！
out = cv2.VideoWriter('gray_output.avi', fourcc, fps, (frame_width, frame_height), isColor=False)

# 检查VideoWriter是否初始化成功
if not out.isOpened():
    print("Error: 无法初始化VideoWriter，请检查Codec或文件路径")
    cap.release()
    exit()

while cap.isOpened():
    ret, frame = cap.read()
    if not ret:
        break
    
    # 转成灰度图
    gray_frame = cv2.cvtColor(frame, cv2.COLOR_BGR2GRAY)
    
    # 写入灰度帧
    out.write(gray_frame)
    
    # 可选：显示预览
    cv2.imshow('Gray Video', gray_frame)
    if cv2.waitKey(1) & 0xFF == ord('q'):
        break

# 释放资源
cap.release()
out.release()
cv2.destroyAllWindows()

3. 注意事项 #

• 保存格式尽量用.avi，因为MJPG和AVI容器的组合兼容性最好；如果用.mp4，需要换对应的Codec（比如cv2.VideoWriter_fourcc(*'avc1')，但部分平台可能需要额外安装依赖）
• isColor=False是灰度视频的核心设置！OpenCV默认是彩色三通道，不设置的话会导致帧格式不匹配，写入完全失败
• 如果是读取本地视频文件保存灰度版，要确保输出的帧宽高和原视频完全一致，不要自行修改尺寸

三、排查现有问题的小技巧 #

1. 先检查你的代码里有没有设置isColor=False，这是灰度视频最容易遗漏的点
2. 打印out.isOpened()的结果，如果是False，说明Codec不被当前平台支持，换MJPG试试
3. 如果文件还是很小，说明根本没有写入帧，检查循环里的ret是否为True，有没有成功读取到帧

补充：你贴的mplayer输出里的LIRC错误是无关的，主要问题还是视频文件本身损坏，无法解析流

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