如何在运行时通过SQLAlchemy为SQLite表动态新增列？

你的场景与需求 #

你通过SQLAlchemy ORM（继承Base类+自定义CustomColumn）创建了固定表结构的SQLite数据库，现在用日志文件填充数据，希望自动化处理日志中出现的新键值对——自动为对应表新增列，且让该列成为数据库和SQLAlchemy元数据的永久属性。

现有代码的问题点 #

• SQL注入风险与语法隐患：直接用f-string拼接ALTER TABLE语句：session.execute(f"ALTER TABLE {table_name} ADD {new_column_name} {new_column_type}")。如果表名/列名包含特殊字符（比如空格、引号），会直接导致SQL语法错误；若来源不可信，还存在SQL注入风险。应该用SQLAlchemy的DDL构造器来生成安全的ALTER语句，或者通过参数化方式处理。
• 元数据同步无效：Base.metadata.tables[table_name].append_column(newColumn)存在两个问题：一是拼写错误（newColumn应为new_column）；二是SQLAlchemy的Table对象本质是不可变结构，append_column只是在当前进程内存中临时添加列，程序重启后元数据会完全重置，新增的列不会被保留。
• ORM类的动态修改不持久：用setattr(ColumnSet, new_column_name, new_column)给ORM类动态添加列属性，仅在当前进程的内存中生效。程序重启后，ColumnSet类还是原来的静态定义，之前动态添加的列会消失——SQLAlchemy的declarative类依赖静态类定义，动态修改无法持久化到类结构中。
• 事务逻辑不严谨：先回滚到savepoint，再执行ALTER TABLE并commit，需要注意SQLite对ALTER TABLE的事务支持（SQLite的ALTER TABLE在多数情况下可以在事务中执行，但要确保事务上下文的一致性）。另外，回滚savepoint后，后续操作的事务状态需要明确，避免出现未预期的事务行为。
• 列类型处理不规范：直接传入new_column_type字符串来定义SQL类型，可能和SQLAlchemy的类型系统不匹配。比如你用的SmallInteger是SQLAlchemy的类型，对应SQL的SMALLINT，如果直接传入字符串可能出现格式或类型不兼容问题，应该通过SQLAlchemy的类型对象来生成对应的SQL类型字符串。

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