返回专栏
专栏 ·

4.3 防御性编程:异常捕获机制(try-except-else-finally)与自定义业务异常体系

作者: 九路 共 12 章 · 48 小节

欢迎回到 HelloWorld 技术社区(www.helloworld.net) 《Python 现代开发实战》专栏。

初级程序员写代码只考虑“一切顺利的快乐路径(Happy Path)”,而高级工程师至少把 40% 的精力花在“如果网络断了、磁盘满了、上游返回空数据怎么办”的防御性设计上。

Python 推崇 EAFP(Easier to Ask for Forgiveness than Permission,请求原谅比请求许可更容易) 哲学——与其在操作前用十层 if 战战兢兢地检查,不如大胆执行并在 try-except 块中优雅兜底。

一、 完整异常处理结构:try-except-else-finally

很多开发者只知道 try-except,却忽略了极其好用的 else 分支:

def parse_user_age(raw_input: str) -> int:
    try:
        # 1. 只把真正可能抛出预期异常的最小代码块放进 try 中
        age = int(raw_input.strip())
    except ValueError as exc:
        # 2. 精准捕获特定异常,严禁写裸露的 except: 吞掉所有错误(包括 Ctrl+C)
        raise ValueError(f"非法的年龄输入 '{raw_input}'") from exc
    else:
        # 3. 只有当 try 块没有抛出任何异常时才会执行(避免把后续业务逻辑误包进 try 里)
        if not (0 <= age <= 150):
            raise ValueError(f"年龄数值超出合理范围: {age}")
        return age
    finally:
        # 4. 无论是否发生异常(甚至哪怕前面执行了 return),都会 100% 执行的清理逻辑
        pass

二、 构建企业级自定义业务异常体系

在大型后端项目中,如果所有业务错误全抛 ValueError 或 RuntimeError,上层全局异常拦截器就无法区分“这是用户余额不足(返回 HTTP 400)”还是“数据库连接池炸了(返回 HTTP 500 并发短信告警)”。

标准架构做法:为项目定义一个统一的根异常基类,再按业务域派生具体子类,并附带错误码与上下文信息:

class HelloWorldBaseError(Exception):
    """社区后端业务异常根基类"""

    def __init__(self, message: str, *, error_code: int = 5000) -> None:
        super().__init__(message)
        self.message = message
        self.error_code = error_code


class InsufficientPointsError(HelloWorldBaseError):
    """用户积分不足异常"""

    def __init__(self, current_points: int, required_points: int) -> None:
        super().__init__(
            f"积分不足:当前 {current_points},兑换需要 {required_points}",
            error_code=4001,
        )


def redeem_merchandise(user_points: int, cost: int) -> str:
    if user_points < cost:
        raise InsufficientPointsError(user_points, cost)
    return "周边兑换成功!"


try:
    redeem_merchandise(user_points=120, cost=500)
except HelloWorldBaseError as err:
    # 上层网关可统一捕获根基类,直接提取标准错误码返回给前端 JSON
    print(f"[API 响应] code={err.error_code}, msg='{err.message}'")

💬 HelloWorld 社区实战打卡

为什么在 Python 代码规范中,写一个不带任何异常类型的裸露 except:(或 except Exception: pass)被视为极其危险的“代码异味”?请结合本节所学,带 #Python专栏打卡 标签在评论区写出你的理解!