当 Flask-SQLAlchemy 模型中定义了与数据库列同名的类方法（如 sholday），该方法会覆盖列属性，导致迁移或 db.create_all() 时该列被忽略，且无任何报错提示。
当 flask-sqlalchemy 模型中定义了与数据库列同名的类方法（如 `sholday`），该方法会覆盖列属性，导致迁移或 `db.create_all()` 时该列被忽略，且无任何报错提示。
在 Flask 应用中使用 SQLAlchemy 定义模型时，列属性（db.Column）与类方法/类属性名称冲突是静默失败的典型陷阱。您遇到的问题——sholday = db.Column(db.Integer) 始终未出现在生成的表结构中——根本原因并非数据库路径、迁移配置或语法错误，而是模型类中存在同名的 @classmethod 方法：
sholday = db.Column(db.Integer) # ← 这行本应创建列
# ...
@classmethod
def sholday(cls, date): # ← 但此方法覆盖了上方的列属性！
holiday = Holidays.query.filter(Holidays.date == date).first()
if holiday:
return holiday.sholday
return False
Python 类属性解析遵循“后定义覆盖先定义”原则。当解释器加载 Holidays 类时，它先执行 sholday = db.Column(...)，将列对象赋值给类属性；但随后执行 def sholday(...) 时，该函数对象直接替换了之前的 Column 对象。因此，Holidays.__table__.columns 中不再包含 sholday 列，db.create_all() 自然跳过它。
✅ 正确做法：严格区分列名与方法名。推荐为查询类方法添加语义前缀，例如：
class Holidays(db.Model):
__tablename__ = 'Holidays'
data_id = db.Column(db.Integer, primary_key=True)
date = db.Column(db.String(10)) # 建议限定长度
test = db.Column(db.String(50))
test2 = db.Column(db.Float)
test3 = db.Column(db.Integer)
test4 = db.Column(db.Boolean)
isholday = db.Column(db.Integer) # 注意拼写一致性
sholday = db.Column(db.Integer) # ← 现在列已正确定义
@classmethod
def get_sholday_by_date(cls, date): # ✅ 重命名方法，避免冲突
holiday = cls.query.filter(cls.date == date).first()
return holiday.sholday if holiday else 0
@classmethod
def does_date_exist(cls, date):
return cls.query.filter(cls.date == date).first() is not None
⚠️ 注意事项：
- 无运行时报错：这是 Python 的正常行为，不会抛出异常，极易被忽视；
- 验证方式：运行 flask shell 后执行 Holidays.__table__.columns.keys()，确认 sholday 是否在列表中；
- 开发建议：启用 SQLALCHEMY_ECHO = True 查看实际执行的 CREATE TABLE 语句；
- 进阶防护：使用 @validates 或 hybrid_property 替代同名方法，或通过 __mapper_args__ 显式声明列；
- 命名规范：列名建议全小写+下划线（如 is_holiday），方法名用动词开头（如 get_is_holiday），从源头规避冲突。
修复后，重新运行 db.create_all()（或删除旧数据库文件后重启应用），sholday 列将正确创建并可读写。
