当前位置:

首页 > 编程开发 > Python中数据库操作与异常处理详解

Python中数据库操作与异常处理详解

Python数据库操作常见异常分为连接层面(如OperationalError需重试)、SQL层面(ProgrammingError需修代码)和数据完整性层面(IntegrityError需业务处理)。应区分异常类型,使用上下文管理器避免资源泄漏,并将异常包装为业务异常以清晰传递上下文。

本文目录

    凌晨两点的报警电话

    去年冬天的一个凌晨,我被手机吵醒了。监控报警:用户注册接口成功率跌到了50%。

    Python中数据库操作与异常处理详解

    迷迷糊糊打开电脑,翻到错误日志,发现全是同一个异常:

    IntegrityError: (1062, "Duplicate entry '13800138000' for key 'phone'")

    事情是这样的:我们在做一个用户注册功能,用户填完手机号提交,系统往数据库里插一条记录。正常情况下,手机号是唯一的,不会重复。但那天因为网络抖动,用户点了两次提交按钮,后端接口收到了两个一模一样的注册请求。

    第一个请求成功了,插入了用户数据。第二个请求来了,发现手机号已经存在,INSERT语句直接报错。然而我们的代码做了什么?它把异常打印到日志,然后给前端返回了一个"服务器错误"。

    用户第二次提交看到的是报错页面,但他不知道的是——第一次提交其实已经注册成功了。他以为没成功,可能又试了第三次、第四次……

    这个Bug暴露了两个问题:一是接口没做幂等处理,二是数据库操作的异常处理写得太粗糙了。

    今天就从这个场景出发,把Python操作数据库时应该怎么处理异常,掰开揉碎了讲清楚。

    数据库操作到底有哪些异常?

    在Python里操作数据库,不管是SQLite、MySQL还是PostgreSQL,常见的异常可以归成几类。

    连接层面的异常

    import sqlite3
    
    try:
        conn = sqlite3.connect('production.db')
    except sqlite3.OperationalError as e:
        print(f"数据库连接失败: {e}")
        # 可能的原因:文件打不开、权限不足、网络不通
    

    OperationalError是操作层面的错误,跟SQL语句本身没关系,是执行环境出了问题。比如:

    • 数据库服务器挂了
    • 连接超时
    • 文件被锁
    • 磁盘满了

    这类错误通常需要重试,或者走降级方案。

    SQL层面的异常(编程错误)

    # 表不存在
    cursor.execute("SELECT * FROM users")  
    # sqlite3.OperationalError: no such table: users
    
    # 列不存在
    cursor.execute("SELECT phone FROM user")  
    # sqlite3.OperationalError: no such column: phone
    
    # SQL语法错误
    cursor.execute("CREATE TABLE users id INTEGER")  
    # sqlite3.OperationalError: near "id": syntax error
    

    ProgrammingError在SQLite里是OperationalError的子集,在MySQL的pymysql里有独立的ProgrammingError。它表示你的代码写错了:

    • 表名或列名拼写错误
    • SQL语法有问题
    • 参数绑定的数量不匹配

    这类错误不应该用重试来解决,正确的做法是修代码。

    数据完整性层面的异常

    # 违反了唯一约束
    cursor.execute("INSERT INTO users (phone) VALUES ('13800138000')")
    # sqlite3.IntegrityError: UNIQUE constraint failed: users.phone
    

    IntegrityError是数据完整性错误。常见于:

    • 主键冲突(重复插入同一主键)
    • 唯一键冲突(重复的手机号、邮箱)
    • 外键约束失败(引用了不存在的父表记录)
    • NOT NULL约束失败

    这类异常往往需要业务逻辑来处理——不是简单报错就完事了,要判断该怎么做。

    业务场景里的正确姿势

    回到注册接口的案例。当捕获到IntegrityError时,正确的做法不是直接返回错误,而是区分情况:

    import sqlite3
    
    def register_user(phone, name):
        try:
            conn.execute(
                "INSERT INTO users (phone, name) VALUES (?, ?)",
                (phone, name)
            )
            conn.commit()
            return {"status": "success", "msg": "注册成功"}
        except sqlite3.IntegrityError as e:
            if "UNIQUE constraint failed: users.phone" in str(e):
                # 手机号已注册,应该返回"用户已存在",而不是"服务器错误"
                return {"status": "exists", "msg": "该手机号已注册"}
            else:
                # 其他完整性错误,记录详细日志
                logger.error(f"IntegrityError: {e}")
                raise
        except sqlite3.OperationalError as e:
            # 连接问题,可以重试
            logger.warning(f"数据库操作失败,准备重试: {e}")
            time.sleep(1)
            return register_user(phone, name)  # 递归重试(要有上限)
    

    关键点是:不要用一个笼统的except Exception把所有异常都吞掉,那样你既不知道出了什么问题,也没法针对性地处理。

    上下文管理器:让你的数据库代码自动"善后"

    很多人的数据库代码长这样:

    def get_user(user_id):
        conn = sqlite3.connect('app.db')
        cursor = conn.cursor()
        cursor.execute("SELECT * FROM users WHERE id = ?", (user_id,))
        result = cursor.fetchone()
        cursor.close()
        conn.close()
        return result
    

    万一execute报错了怎么办?cursor.close()和conn.close()都不会被执行,连接就泄漏了。

    用with(上下文管理器)来解决:

    def get_user(user_id):
        with sqlite3.connect('app.db') as conn:
            with conn.cursor() as cursor:
                cursor.execute("SELECT * FROM users WHERE id = ?", (user_id,))
                return cursor.fetchone()
        # 退出with块时,cursor和conn会自动关闭,即使发生了异常
    

    with块保证资源被正确释放。如果你用的是ORM(如SQLAlchemy),它也有类似的上下文管理机制。

    自定义异常:让错误信息带上业务上下文

    当异常发生时,原始的数据库错误信息(比如"Table doesn't exist")对用户来说是毫无意义的。更好的做法是把异常包装一下。

    class UserRegistrationError(Exception):
        """用户注册相关的所有异常的基类"""
        pass
    
    class UserAlreadyExistsError(UserRegistrationError):
        pass
    
    class DatabaseConnectionError(UserRegistrationError):
        pass
    
    def register_user(phone, name):
        try:
            # 数据库操作...
        except sqlite3.IntegrityError as e:
            if "UNIQUE constraint" in str(e):
                raise UserAlreadyExistsError(f"手机号{phone}已注册") from e
        except sqlite3.OperationalError as e:
            raise DatabaseConnectionError("数据库暂时不可用") from e
    

    这样在业务层捕获异常时,可以直接按类型处理:

    try:
        result = register_user(phone, name)
    except UserAlreadyExistsError:
        # 前端显示"用户已存在"
    except DatabaseConnectionError:
        # 前端显示"系统繁忙,请稍后重试"
    

    raise ... from e的写法保留了原始异常信息,方便调试。

    一个完整的实战模板

    把上面所有内容整合成一个可复用的模板:

    import sqlite3
    import time
    import logging
    
    logger = logging.getLogger(__name__)
    
    class DatabaseError(Exception):
        pass
    
    class DuplicateRecordError(DatabaseError):
        pass
    
    def with_retry(max_retries=3, delay=1):
        """重试装饰器,用于处理临时性数据库错误"""
        def decorator(func):
            def wrapper(*args, **kwargs):
                for attempt in range(max_retries):
                    try:
                        return func(*args, **kwargs)
                    except sqlite3.OperationalError as e:
                        if attempt == max_retries - 1:
                            raise DatabaseError(f"操作失败,已重试{max_retries}次") from e
                        logger.warning(f"第{attempt+1}次重试,错误: {e}")
                        time.sleep(delay * (attempt + 1))  # 指数退避
            return wrapper
        return decorator
    
    @with_retry(max_retries=3)
    def create_user(phone, name):
        try:
            with sqlite3.connect('app.db') as conn:
                conn.execute(
                    "INSERT INTO users (phone, name) VALUES (?, ?)",
                    (phone, name)
                )
                conn.commit()
                return {"id": conn.lastrowid, "phone": phone}
        except sqlite3.IntegrityError as e:
            if "UNIQUE constraint" in str(e):
                raise DuplicateRecordError(f"手机号{phone}已存在") from e
            raise DatabaseError(f"数据完整性错误: {e}") from e
    

    总结:记住三条原则

    1. 区分异常类型:OperationalError重试,IntegrityError走业务逻辑,ProgrammingError改代码。
    2. 用上下文管理器:数据库连接和游标用with管理,避免资源泄漏。
    3. 把异常包装成业务异常:让上层代码按业务逻辑处理,而不是处理数据库底层错误。

    那次凌晨的报警之后,所有数据库操作都按照这个模板重构了。后来再遇到网络抖动、重复提交这类问题,代码都能正确处理——要么重试成功,要么返回明确的业务提示,再也没有半夜的报警电话了。

    本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系bd@zhengruan.com
    作者最新文章
    编程开发 Python
    相关文章 更多
    python删除一个列表里的重复元素的方法与代码示例
    python删除一个列表里的重复元素的方法与代码示例

    学习如何使用Python高效删除列表中的重复元素。本文提供5种常见方法的代码示例,涵盖保持顺序与不保持顺序的场景,适合初学者和进阶开发者参考。

    Python写接口的步骤及完整代码示例
    Python写接口的步骤及完整代码示例

    详细讲解使用Python编写Web接口的核心步骤与完整代码示例,涵盖环境准备、路由定义、数据校验、服务启动及调试测试方法。

    codex怎么读取word文档及docx文件操作教程
    codex怎么读取word文档及docx文件操作教程

    介绍如何利用编程工具读取和解析Word文档(docx格式),涵盖基础文本提取代码示例、结构化数据处理逻辑,以及处理复杂排版时的技术局限与替代方案。

    怎么在Python中调用C语言代码提升性能
    怎么在Python中调用C语言代码提升性能

    详细讲解在Python中调用C语言代码提升性能的完整实践指南,包含原理分析、编译步骤、ctypes与CFFI具体实现、性能对比及常见陷阱。

    Python与C语言的性能差异及底层原理
    Python与C语言的性能差异及底层原理

    深入解析Python与C语言在执行效率上的数量级差异,从编译机制、变量内存布局、动态类型推断到GIL锁,系统阐明底层核心原理。

    Python和C语言哪个更适合编程入门
    Python和C语言哪个更适合编程入门

    客观对比Python与C语言在心智负担、底层机制与学习反馈上的核心差异,提供清晰有据的选择标准与切实的入门学习路径。

    selenium上传文件教程本地文件路径设置方法
    selenium上传文件教程本地文件路径设置方法

    深入解析Selenium处理文件上传的技术细节,涵盖标准HTML控件的路径直接注入法与非标准控件的系统级模拟方案,提供Windows与Linux环境下的路径设置最佳实践及常见异常排查。

    大数据开发语言选型:Java对比Scala与Python的优缺点及适用场景
    大数据开发语言选型:Java对比Scala与Python的优缺点及适用场景

    针对大数据工程场景,系统对比Java、Scala与Python在执行性能、生态结合、开发效率和维护成本上的核心差异,给出清晰的架构选型依据与落地方案。

    langgraph python guide中文入门教程详解
    langgraph python guide中文入门教程详解

    本篇LangGraph Python中文入门教程详解,系统梳理StateGraph状态机定义、节点编写、边与条件路由、检查点持久化(MemorySaver)等核心机制,提供从环境安装到完整循环智能体构建的代码示例与实操指导。

    Windows 安装 Python:从官方入口到虚拟环境的可复现实践
    Windows 安装 Python:从官方入口到虚拟环境的可复现实践

    面向后端开发者,基于 Python 官方文档说明如何在 Windows 上安装 Python、创建 venv 虚拟环境及使用 pip 管理依赖。包含可复制命令、验证方法及工具选择边界,避免常见配置误区。

    查看更多
    精品专题 更多
    装机必备
    装机必备

    正软商城装机必备专区,精选办公、浏览器、安全防护、影音播放、压缩解压、设计创作和系统工具等电脑常用正版软件,帮助用户快速完成新电脑软件配置。

    Windows
    Windows

    正软商城Windows软件专区,汇集适用于Windows电脑的办公、设计、安全防护、影音播放、开发工具和系统优化软件,提供软件介绍、系统要求、正版授权及购买下载服务。

    PDF教程
    PDF教程

    正软商城PDF教程频道提供PDF编辑、转换、合并、拆分、压缩及格式处理方法,同时介绍常用PDF软件和工具的使用技巧。

    Mac软件 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    Aperty macOS版
    Aperty macOS版
    macOS

    Aperty 是 Skylum 推出的 AI 人像修图软件,支持自然肤质修饰、瑕疵处理、面部与身体调整、预设及批量同步。

    WINDOWS 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    PixTV 网页版
    PixTV 网页版
    Windows

    PixTV 是一款在浏览器中使用的 AI 视觉内容创作平台,提供图片、视频、音频、文字生成、AI 分镜、局部重绘、提示词反推和无限画布等工具,适合短剧、漫剧、广告及社交媒体内容制作。