Prefect与aiosqlite依赖问题：sqlalchemy.OperationalError异常求助

可能原因 #

该错误源于Prefect的SQLite数据库中ix_block_document__block_type_name_name索引已存在，但任务启动时仍尝试重复创建。常见触发场景：

• 之前的Prefect进程异常退出，导致数据库迁移未完成
• 本地Prefect SQLite数据库文件出现损坏或数据不一致

具体解决步骤 #

1. 重置本地Prefect数据库 #

Prefect默认使用的SQLite数据库路径：

• macOS/Linux：~/.prefect/prefect.db
• Windows：%USERPROFILE%\.prefect\prefect.db

删除该数据库文件后重新运行任务：

# macOS/Linux
rm ~/.prefect/prefect.db

# Windows（PowerShell）
Remove-Item $env:USERPROFILE\.prefect\prefect.db

2. 手动执行数据库迁移 #

若不想删除数据库，可手动触发Prefect的数据库迁移命令修复索引问题：

prefect database upgrade -y

3. 调整aiosqlite版本 #

部分用户反馈aiosqlite==0.19.0与Prefect 2.14.x存在兼容性冲突，尝试降级到0.18.0：

pip install aiosqlite==0.18.0

4. 验证修复结果 #

重新调用full_data_ingestion任务，确认异常是否消除：

from your_script_module import full_data_ingestion

full_data_ingestion()

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