PythonAnywhere运行Flask代码报错：无法组装preferencias表主键列

核心问题分析 #

错误提示Mapper mapped class Preferencia->preferencias could not assemble any primary key columns for mapped table 'preferencias'，但你的代码已明确为Preferencia类指定__tablename__ = "data"，且定义了主键id。问题根源在于：

• PythonAnywhere环境中存在旧数据库文件或SQLAlchemy元数据缓存，导致系统仍尝试映射默认表名preferencias（类名小写复数形式），但该表要么无主键，要么并非当前代码定义的表。
• 本地VSCode运行正常是因为本地数据库是基于当前代码生成，无遗留旧表或缓存。

具体解决步骤 #

1. 清理PythonAnywhere上的旧数据库文件 #

• 登录PythonAnywhere控制台，进入项目目录，检查是否存在旧数据库文件（如preferencias.sqlite3），直接删除。
• 备份当前preferences.sqlite3后删除，重新运行db.create_all()，让系统根据当前代码生成全新数据库表。

2. 强制刷新SQLAlchemy元数据缓存 #

临时修改启动代码，清除缓存后再创建表（执行一次后可移除该代码）：

if __name__ == "__main__":
    db.metadata.clear()  # 清除元数据缓存
    db.create_all()
    app.run(debug=True)

3. 验证数据库路径正确性 #

在PythonAnywhere中，SQLite数据库路径相对项目根目录，可打印绝对路径确认：

import os
print(os.path.abspath('preferences.sqlite3'))

检查输出路径是否为预期位置，避免因路径错误访问了旧数据库。

4. 确认表结构 #

重新生成数据库后，在PythonAnywhere终端连接SQLite验证表结构：

sqlite3 preferences.sqlite3

进入SQLite命令行后执行：

PRAGMA table_info(data);

确认输出中包含id字段且标记为primary key。

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