Alembic sqlalchemy.exc.NoReferencedColumnError：（使用 Flask-sqlalchemy 和 Flask-Migrate）答案

【问题标题】：Alembic sqlalchemy.exc.NoReferencedColumnError: (Using Flask-sqlalchemy and Flask-Migrate)Alembic sqlalchemy.exc.NoReferencedColumnError：（使用 Flask-sqlalchemy 和 Flask-Migrate）
【发布时间】：2025-12-27 06:10:07
【问题描述】：

当我尝试迁移我的架构时，即使初始迁移顺利进行，Alembic 仍然给我这个错误。

sqlalchemy.exc.NoReferencedColumnError: Could not initialize target column for ForeignKey 'dataset.datasetid' on table 'analysis': table 'dataset' has no column named 'datasetid'

这是我的models.py类的一部分

class Dataset(db.Model):
    DatasetID = db.Column(db.Integer, primary_key = True)
    SampleID = db.Column(db.String(50), db.ForeignKey('sample.SampleID', onupdate="cascade",ondelete="restrict"), nullable=False)
    UploadDate = db.Column(db.Date, nullable=False)
    UploadID = db.Column(db.Integer,db.ForeignKey('uploaders.UploadID', onupdate="cascade",ondelete="restrict"), nullable=False)
    UploadStatus = db.Column(db.String(45), nullable=False)
    HPFPath = db.Column(db.String(500))
    DatasetType = db.Column(db.String(45), nullable=False)
    SolvedStatus = db.Column(db.String(30), nullable=False)
    InputFile = db.Column(db.Text)
    RunID = db.Column(db.String(45))
    Notes = db.Column(db.Text)
    analyses = db.relationship('Analysis',backref='dataset',lazy='dynamic')
    data2Cohorts = db.relationship('Dataset2Cohort',backref='dataset',lazy='dynamic')

class Dataset2Cohort(db.Model):
    __tablename__='dataset2Cohort'
    DatasetID = db.Column(db.Integer, db.ForeignKey('dataset.DatasetID', onupdate="cascade",ondelete="cascade"), nullable=False, primary_key = True)
    CohortID = db.Column(db.Integer, db.ForeignKey('cohort.CohortID', onupdate="cascade", ondelete="restrict"),  nullable=False, primary_key = True)

class Analysis(db.Model):
    AnalysisID = db.Column(db.String(100), primary_key = True)
    DatasetID = db.Column(db.Integer, db.ForeignKey('dataset.DatasetID', onupdate="cascade",ondelete="cascade"), nullable=False)
    PipelineVersion = db.Column(db.String(30))
    ResultsDirectory = db.Column(db.Text)
    ResultsBAM = db.Column(db.Text)
    AssignedTo = db.Column(db.String(100), nullable=True)
    analysisStatuses = db.relationship('AnalysisStatus', backref='analysis', lazy='dynamic')

有谁知道为什么即使我在数据集表中有 DatasetID 列，我仍然会收到该错误？

谢谢你，泰迦。

【问题讨论】：

我建议您使用小写的变量/列名。所以不要使用DatasetID，而是使用dataset_id。这样可以避免这样的问题。此外，使用下划线命名变量和列更为传统（参见样式指南python.org/dev/peps/pep-0008）
谢谢乔纳斯。我会记住这一点。有没有办法强制 alembic/sqlalchemy 像现在一样识别我的列名？还是将我的所有列名重命名为小写/常规命名的唯一方法？光辉。

标签： flask-sqlalchemy alembic flask-migrate

【解决方案1】：

找到了解决办法。

这似乎是 Mysql 8.x 版本如何引用外键声明中的列名的问题 - 当在外键语句中引用列时，Mysql 8.x 版本总是使用小写，这会导致与 sqlalchemy 不兼容.这个问题在这里讨论

https://github.com/sqlalchemy/sqlalchemy/issues/4344

解决方案是将 sqlalchemy 升级到最新版本 (>=1.2.x)

光辉。

【讨论】：