Python Flask操作PostgreSQL表时，NoSuchTableError与ProgrammingError的差异

两者核心区别 #

• NoSuchTableError：SQLAlchemy专属的细分异常，仅在ORM元数据层面检测到目标表不存在时触发。比如你没定义对应Model类，或者手动从SQLAlchemy的元数据中移除了表的记录，此时执行操作才会抛出这个异常。它是SQLAlchemy内部逻辑判断的结果，和数据库实际状态无关。
• ProgrammingError：属于数据库驱动（比如psycopg2）向上抛出的通用异常，SQLAlchemy会对其进行包装。只要数据库执行SQL时返回语法错误、引用不存在的对象（表/列）等“程序逻辑错误”类的问题，都会触发这个异常。它直接对应数据库实际返回的错误信息。

为什么捕获NoSuchTableError无效 #

你手动删除数据库中的表后，SQLAlchemy的ORM元数据里还存在该表的定义（因为你写的Model类还在）。当执行查询时，SQLAlchemy会基于元数据生成合法的SELECT语句发送给PostgreSQL，此时PostgreSQL发现表不存在，返回“relation does not exist”的错误，这个错误被psycopg2包装成ProgrammingError，再被SQLAlchemy转抛为sqlalchemy.exc.ProgrammingError。

整个过程中，SQLAlchemy内部并没有检测到元数据里缺少这个表，所以不会抛出NoSuchTableError。只有当你尝试操作一个根本没在元数据中注册的表（比如直接写原生SQL引用一个没定义Model的表，且元数据里也没加），才会触发NoSuchTableError。

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