SQLAlchemy 默认会对所有数据库操作（包括 SELECT）隐式启动事务，即使仅执行只读查询；它不提供原生 readOnly=true 机制，但可通过 Session 事件和自定义逻辑模拟真正只读会话，避免意外写入与资源开销。
sqlalchemy 默认会对所有数据库操作（包括 select）隐式启动事务，即使仅执行只读查询；它不提供原生 `readonly=true` 机制，但可通过 session 事件和自定义逻辑模拟真正只读会话，避免意外写入与资源开销。
在 SQLAlchemy 中，事务并非按“读/写语义”惰性创建，而是按“会话活跃度”自动开启。当你首次调用 session.execute()、session.query() 或任何触发数据库交互的方法（如 session.get()）时，SQLAlchemy 会自动启动一个“隐式事务”（implicit transaction），即使该操作仅为 SELECT。这与 Spring Data JPA 的 @Transactional(readOnly = true) 有本质区别：后者显式声明事务边界并可能触发数据库级只读优化（如 PostgreSQL 的 SET TRANSACTION READ ONLY），而 SQLAlchemy 的默认行为是始终开启可写事务，无论是否实际执行 INSERT/UPDATE。
这意味着以下代码仍会启动事务：
session = SessionLocal() users = session.execute(select(User)).scalars().all() # ✅ 隐式开启事务
即便未调用 session.commit() 或 session.flush()，该事务也会在 session.close() 或上下文退出时被回滚（若未显式提交），造成轻微但可避免的连接与事务管理开销。
如何实现真正的只读会话？
SQLAlchemy 本身不内置 readonly=True 参数，但可通过组合 Session.info 元数据与 SessionEvents 实现健壮的只读防护：
-
标记会话为只读：利用
session.info存储状态（轻量、线程安全）； -
拦截写入操作：监听
before_flush和before_commit事件，主动抛出异常； -
（可选）启用数据库级只读：对支持的后端（如 PostgreSQL），可在
engine.connect()时执行SET TRANSACTION READ ONLY，但需注意该设置作用于连接而非 Session 级别。
以下是生产就绪的只读会话封装示例：
from sqlalchemy import create_engine, event, text
from sqlalchemy.orm import Session, sessionmaker
def make_readonly_session(session: Session) -> Session:
"""将 Session 标记为只读，并注册防护事件"""
session.info["readonly"] = True
@event.listens_for(session, "before_flush", once=True)
def prevent_flush(session, flush_context, instances):
if session.info.get("readonly"):
raise RuntimeError("Flush forbidden in readonly session")
@event.listens_for(session, "before_commit", once=True)
def prevent_commit(session, transaction):
if session.info.get("readonly"):
raise RuntimeError("Commit forbidden in readonly session")
return session
# 使用示例（FastAPI 依赖注入风格）
def get_readonly_db():
session = SessionLocal()
make_readonly_session(session)
try:
yield session
finally:
session.close()
⚠️ 注意事项：
session.execute(select(...))仍会开启事务，但上述防护可确保flush/commit失败，避免脏写；- 若需彻底避免事务开销（如高并发统计查询），建议改用
engine.connect().execute()并显式控制连接生命周期，绕过 ORM Session；- 对于 PostgreSQL，可结合
connect_args={"options": "-c default_transaction_read_only=on"}启用连接级只读，但需确保应用逻辑完全无写操作，否则将报错。
总结而言：SQLAlchemy 总是为首次数据库访问开启事务，不存在“零事务开销”的纯只读 Session。但通过事件驱动的防护机制，你既能获得语义清晰的只读契约，又能防止误写，兼顾安全性与可观测性——这正是在 FastAPI + SQLAlchemy 架构中构建可靠数据访问层的关键实践。
