django-plotly-dash中Dash应用阻塞migrate，如何阻止迁移时执行Dash代码？

问题根因 #

你遇到的报错本质是模块顶层代码在导入阶段就自动执行：Django 运行 migrate 命令时会自动加载所有已注册应用的模块，你把 SQL 查询、数据库连接的逻辑直接写在 dashapp.py 顶层，模块被导入时就会立刻执行，此时迁移流程还没创建对应数据表，自然触发报错。

你的猜测完全正确，只需要调整代码结构就能解决问题，以下是优先级从高到低的几种方案：

方案1：将数据库操作封装到函数/回调中（最推荐） #

不要在模块顶层执行任何 IO 类操作，把 SQL 查询逻辑放到 Dash 回调或者独立函数中，只有当 Dash 应用实际被访问、需要用到数据时才执行，模块导入阶段不会触发这部分代码。
示例修改如下：

# dashapp.py 顶层仅做 Dash 实例初始化，不执行实际查询
import dash
from dash import html, dcc
import psycopg2
import pandas as pd

# 初始化Dash实例，这部分不涉及数据库操作，可放在顶层
app = dash.Dash(__name__, requests_pathname_prefix='/dash/')

# 封装查询逻辑为独立函数
def get_veh_data():
    queryStr = '''
    SELECT veh.number as veh,
           dh.rcmdh_number as dh,
    from 
         rcm_rcmveh as veh,
         rcma_rcmdh as dh,
    where sige.sig_id = sig.id 
          AND sig.unit_id = veh .id
          '''
    cnx = psycopg2.connect(
        host=POSTGRES_ADDRESS,
        database=POSTGRES_DBNAME,
        user=POSTGRES_USERNAME,
        password=POSTGRES_PASSWORD)
    df = pd.read_sql_query(queryStr, cnx)
    cnx.close()
    return df

# 在回调中调用函数获取数据，只有回调被触发时才会执行查询
@app.callback(
    dash.dependencies.Output('some-graph', 'figure'),
    [dash.dependencies.Input('page-load-trigger', 'value')]
)
def update_graph(_):
    df = get_veh_data()
    # 后续绘图逻辑
    ...

# 页面布局定义
app.layout = html.Div([
    dcc.Input(id='page-load-trigger', value='init', style={'display': 'none'}),
    dcc.Graph(id='some-graph')
])

如果希望数据仅全局加载一次、不用每次回调都查，可增加惰性缓存逻辑：

# 全局缓存变量，初始值为None
_cached_df = None

def get_veh_data():
    global _cached_df
    if _cached_df is None:
        # 仅第一次调用时执行查询
        queryStr = '''你的SQL语句'''
        cnx = psycopg2.connect(...)
        _cached_df = pd.read_sql_query(queryStr, cnx)
        cnx.close()
    return _cached_df

方案2：临时判断运行命令（快速兼容） #

如果暂时不想调整代码结构，可以加一层命令判断，只有当前不是执行 migrate 操作时才运行查询逻辑：

import sys

if 'migrate' not in sys.argv:
    # 原有的顶层查询逻辑放在这个判断内
    queryStr = '''...'''
    cnx = psycopg2.connect(...)
    df = pd.read_sql_query(queryStr, cnx)

该方案属于临时兼容方案，适配性不如方案1，仅做应急选择。

额外优化建议 #

你可以直接用 Django 自带的数据库连接执行 SQL，不需要单独维护 PostgreSQL 连接参数，更符合 Django 开发规范：

from django.db import connection
import pandas as pd

def get_veh_data():
    with connection.cursor() as cursor:
        cursor.execute('''你的SQL语句''')
        # 提取列名生成DataFrame
        columns = [col[0] for col in cursor.description]
        df = pd.DataFrame(cursor.fetchall(), columns=columns)
    return df

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