Flask API遇ImportError：无法导入sqlalchemy的ASSOCIATION_PROXY

问题根源 #

你遇到的ImportError确实是Flask-Admin与SQLAlchemy版本冲突导致的：SQLAlchemy 2.0+版本中移除了sqlalchemy.ext.associationproxy模块下的ASSOCIATION_PROXY常量，而旧版本的Flask-Admin代码依然依赖这个常量导入，因此触发报错。安装新包时，pipenv会自动升级依赖树中的相关包（包括SQLAlchemy），这就是为什么每次装新包后都会出问题——即使卸载新包，已经升级的SQLAlchemy不会自动降级，问题依然存在。

解决方案 #

1. 降级SQLAlchemy到兼容版本 #

将SQLAlchemy固定到1.4.x系列（Flask-Admin稳定版的兼容版本），执行命令：

pipenv install sqlalchemy~=1.4.49

2. 使用Flask-Admin开发版（适配SQLAlchemy 2.0） #

如果需要保留SQLAlchemy 2.0+，可以安装Flask-Admin的最新开发版（已修复兼容问题）：

pipenv install git+https://github.com/flask-admin/flask-admin.git@master

3. 固定依赖版本避免后续问题 #

在Pipfile中明确指定核心依赖的版本范围，防止自动升级到不兼容版本，示例：

[packages]
flask = "*"
flask-sqlalchemy = "~=2.5.1"
flask-admin = "~=1.6.1"
sqlalchemy = "~=1.4.49"

修改后执行pipenv install重新锁定依赖。

内容的提问来源于stack exchange，提问作者brandon.c