FastAPI连接PostgreSQL时报check_same_thread无效连接选项错误

check_same_thread是SQLite数据库专属的连接配置参数，仅对SQLite驱动生效，作用是关闭SQLite默认的「连接仅允许创建它的线程访问」的限制——SQLite本身不支持多线程共享连接，FastAPI多线程处理请求时，使用SQLite必须配置该参数才能正常运行。
PostgreSQL的psycopg2驱动无法识别check_same_thread这个连接选项，从SQLite切换到PostgreSQL时如果原封不动保留这套connect_args配置，驱动解析连接参数时就会抛出无效连接选项的错误。

根据实际使用场景选择对应修改方式即可：

• 仅使用PostgreSQL作为数据库：直接删除create_engine调用中的connect_args参数即可。PostgreSQL原生支持多线程连接访问，不需要该特殊参数。
  修改后的可用配置代码：

  from sqlalchemy import create_engine
  from sqlalchemy.ext.declarative import declarative_base
  from sqlalchemy.orm import sessionmaker
  
  #SQLALCHEMY_DATABASE_URL = "sqlite:///./sql_app.db"
  SQLALCHEMY_DATABASE_URL = "postgresql://user:password@postgresserver/db"
  
  engine = create_engine(SQLALCHEMY_DATABASE_URL)
  SessionLocal = sessionmaker(autocommit=False, autoflush=False, bind=engine)
  
  Base = declarative_base()
  

• 需要同时兼容SQLite、PostgreSQL（比如本地开发用SQLite，生产环境用PostgreSQL）：增加数据库类型判断，仅当使用SQLite时传入check_same_thread参数。
  兼容配置代码：

  from sqlalchemy import create_engine
  from sqlalchemy.ext.declarative import declarative_base
  from sqlalchemy.orm import sessionmaker
  
  # 可通过环境配置切换连接地址
  SQLALCHEMY_DATABASE_URL = "postgresql://user:password@postgresserver/db"
  # SQLALCHEMY_DATABASE_URL = "sqlite:///./sql_app.db"
  
  connect_args = {}
  # 仅SQLite需要传入check_same_thread参数
  if SQLALCHEMY_DATABASE_URL.startswith("sqlite"):
      connect_args["check_same_thread"] = False
  
  engine = create_engine(SQLALCHEMY_DATABASE_URL, connect_args=connect_args)
  SessionLocal = sessionmaker(autocommit=False, autoflush=False, bind=engine)
  
  Base = declarative_base()
  

注意：使用PostgreSQL前请确保已安装对应驱动，未安装的话执行pip install psycopg2-binary完成安装，同时连接串需要替换为实际的数据库地址、账号、密码、库名。

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