使用Dash中Plotly Quiver图时遇UnboundLocalError问题求助

错误根源 #

你遇到的UnboundLocalError: local variable 'point1_x' referenced before assignment，直接原因是传入ff.create_quiver的数组是空的（形状为(0,)）。ff.create_quiver内部会基于输入数据计算箭头的起点和终点坐标，当输入数据为空时，相关变量（比如point1_x）不会被初始化，程序尝试引用时就会抛出这个错误。

解决方案 #

1. 前置数据校验 #

在调用绘图函数前，先检查数据数组是否非空，只有当数据有效时才执行绘图逻辑：

import numpy as np
import plotly.figure_factory as ff
import plotly.graph_objects as go

# 假设从数据流读取后得到的列表
pos_x_list = []  # 实际替换为你的数据流读取逻辑
pos_y_list = []
vel_x_list = []
vel_y_list = []

# 转为numpy数组
pos_x = np.array(pos_x_list)
pos_y = np.array(pos_y_list)
vel_x = np.array(vel_x_list)
vel_y = np.array(vel_y_list)

# 校验数据有效性
if all(arr.size > 0 for arr in [pos_x, pos_y, vel_x, vel_y]):
    # 数据有效时绘制箭头图
    fig = ff.create_quiver(pos_x, pos_y, vel_x, vel_y)
else:
    # 空数据时生成提示图
    fig = go.Figure()
    fig.update_layout(title="暂无有效数据")
    fig.add_annotation(
        text="请检查数据流连接或等待数据加载",
        x=0.5, y=0.5,
        showarrow=False,
        font={"size": 14}
    )

# 后续在Dash中渲染fig的逻辑

2. 排查数据流读取逻辑 #

• 确认数据流是否真的返回了数据：可以在转数组前打印列表长度，比如print(len(pos_x_list))，如果始终为0，说明数据流读取环节有问题（比如连接失败、数据格式不匹配、未触发数据更新）。
• 如果是实时数据流（比如WebSocket、定时拉取），确保在Dash回调中监听数据更新事件，只有当新数据到达时才重新生成图表，避免初始无数据时执行绘图逻辑。

3. 空数据场景的兼容处理 #

如果业务上允许空数据存在，除了生成提示图，也可以提前初始化一个极小的 dummy 数据让ff.create_quiver正常执行，比如：

# 当数据为空时，生成一个隐藏的箭头图
if all(arr.size == 0 for arr in [pos_x, pos_y, vel_x, vel_y]):
    pos_x = np.array([0])
    pos_y = np.array([0])
    vel_x = np.array([0])
    vel_y = np.array([0])
    fig = ff.create_quiver(pos_x, pos_y, vel_x, vel_y)
    fig.update_traces(visible=False)  # 隐藏箭头

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