Python视频处理库异常处理设计：自定义异常与标准异常的选择及实践疑问

给你的具体方案建议 #

结合你的场景，我建议混合使用标准异常和自定义异常，兼顾精准性和易用性：

1. 视频文件不存在：直接用FileNotFoundError，完全匹配语义。
2. 视频无法打开/无法读取帧：用自定义VideoProcessingError(ValueError)，精准标识视频处理特有的无效状态。
3. 校准失败：用自定义CalibrationError(RuntimeError)，标识业务逻辑独有的错误。

优化后的Detector代码：

from pathlib import Path
import cv2

class VideoProcessingError(ValueError):
    """视频加载或帧读取过程中发生的错误"""
    pass

class CalibrationError(RuntimeError):
    """因检测数量不足导致校准失败的错误"""
    pass

class Detector:
    # 将异常绑定为类属性，方便用户访问
    VideoProcessingError = VideoProcessingError
    CalibrationError = CalibrationError

    def _validate_video(self, video_path):
        if not Path(video_path).exists():
            raise FileNotFoundError(f"视频文件不存在: {video_path}")
        cap = cv2.VideoCapture(str(video_path))
        if not cap.isOpened():
            raise VideoProcessingError(f"无法打开视频文件: {video_path}")
        ret, frame = cap.read()
        if not ret:
            raise VideoProcessingError(f"无法读取视频帧: {video_path}")

    def _calibrate(self, video_path):
        # 模拟校准逻辑
        detection_count = 0
        if detection_count < 5:
            raise CalibrationError(f"校准失败: 仅检测到{detection_count}个目标（至少需要5个）")

    def run(self, video_path):
        self._validate_video(video_path)
        self._calibrate(video_path)

使用示例（两种方式都支持）：

# 方式1：精准捕获，无需额外导入
from mylib import Detector

try:
    detector = Detector()
    detector.run("video.mp4")
except FileNotFoundError:
    print("处理文件缺失逻辑")
except Detector.VideoProcessingError:
    print("处理视频加载/读取错误")
except Detector.CalibrationError:
    print("处理校准失败逻辑")

# 方式2：兜底捕获，不用关心自定义异常
try:
    detector.run("video.mp4")
except FileNotFoundError:
    print("处理文件缺失逻辑")
except ValueError:
    # 会捕获VideoProcessingError，因为它继承自ValueError
    print("处理视频相关无效错误")
except RuntimeError:
    # 会捕获CalibrationError
    print("处理运行时业务逻辑错误")

这样既保留了自定义异常的精准性，又兼顾了用户的使用便捷性，完全符合主流库的设计风格。

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