Mac下OpenCV无法保存FaceTime摄像头视频问题求助

问题现象 #

• 可正常调用FaceTime摄像头，实时显示并翻转视频画面
• 尝试保存视频时，完全生成不了目标文件，且无任何报错信息
• 此前曾出现编解码器相关错误：CAP_IMAGES: can't find starting number (in the name of file):，按照建议安装FFmpeg并指定mp4v编解码器后，问题仍未解决

需求 #

将摄像头采集的视频保存为文件，后续用于网页安防直播场景

相关信息 #

多版调试代码示例 #

# 版本1：基础保存逻辑
import cv2

cap = cv2.VideoCapture(0)
if not cap.isOpened():
    print("无法打开摄像头")
    exit()

# 获取摄像头参数
fps = cap.get(cv2.CAP_PROP_FPS)
width = int(cap.get(cv2.CAP_PROP_FRAME_WIDTH))
height = int(cap.get(cv2.CAP_PROP_FRAME_HEIGHT))

# 设置编解码器与写入器
fourcc = cv2.VideoWriter_fourcc(*'mp4v')
out = cv2.VideoWriter('output.mp4', fourcc, fps, (width, height))

while True:
    ret, frame = cap.read()
    if not ret:
        print("无法获取帧")
        break
    # 翻转画面（适配FaceTime镜像）
    frame = cv2.flip(frame, 1)
    cv2.imshow('Camera', frame)
    out.write(frame)
    
    if cv2.waitKey(1) & 0xFF == ord('q'):
        break

cap.release()
out.release()
cv2.destroyAllWindows()

# 版本2：强制指定摄像头索引与编码尝试
import cv2

# 尝试指定摄像头索引为1（部分Mac设备FaceTime对应索引1）
cap = cv2.VideoCapture(1)
cap.set(cv2.CAP_PROP_FRAME_WIDTH, 1280)
cap.set(cv2.CAP_PROP_FRAME_HEIGHT, 720)
cap.set(cv2.CAP_PROP_FPS, 30)

if not cap.isOpened():
    print("摄像头打开失败")
    exit()

fourcc = cv2.VideoWriter_fourcc(*'avc1')  # 换用H.264编码尝试
out = cv2.VideoWriter('output_h264.mp4', fourcc, 30, (1280, 720))

while True:
    ret, frame = cap.read()
    if not ret:
        break
    frame = cv2.flip(frame, 1)
    cv2.imshow('Cam', frame)
    if out.isOpened():
        out.write(frame)
    
    if cv2.waitKey(1) & 0xFF == ord('q'):
        break

cap.release()
out.release()
cv2.destroyAllWindows()

OpenCV配置信息 #

opencv-python 4.8.1.78
配置参数：
- WITH_FFMPEG: YES
- VIDEOIO_ENABLED_PLUGINS: YES
- BUILD_opencv_videoio_ffmpeg: YES

已安装Python模块列表 #

Package                Version
---------------------- -----------
opencv-python          4.8.1.78
numpy                  1.26.1
pillow                 10.1.0
ffmpeg-python          0.2.0

排查方向建议 #

1. 文件路径权限检查：确保保存路径有写入权限，避免写入系统保护目录（如根目录、/Applications等），尝试写入用户桌面或文档目录
2. 编解码器兼容性验证：
   • 尝试使用cv2.VideoWriter_fourcc(*'MJPG')生成.avi格式文件，验证写入逻辑是否正常
   • 检查FFmpeg是否正确集成：运行ffmpeg -codecs查看是否支持mp4v、avc1编码
3. 摄像头参数匹配：确保VideoWriter的分辨率、帧率与摄像头实际输出完全一致，可通过cap.get()获取真实参数后再传入，避免手动硬编码
4. 资源释放逻辑检查：确保退出循环后out.release()被执行到，可在释放前打印日志确认，避免程序异常退出导致文件未完成写入
5. 测试无GUI写入：注释掉cv2.imshow()相关代码，仅执行视频采集与写入，排除GUI线程干扰

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