QMT 平台 xtdata.download_financial_data 下载财务数据卡死怎么办？

函数xtdata.download_financial_data会hang

code_list = ["000001.SZ"]
xtdata.download_financial_data(code_list)
​
xtdata.download_financial_data 会 Hang, 不返回。请问如何解决？

调用其他 API 没有问题，说明本地环境是 OK 的

在 QMT (迅投) 量化平台中使用 xtdata.download_financial_data 下载财务数据时遇到程序挂起 (Hang) 且不返回结果，而其他 API 调用正常，通常是由以下几个原因引起的。请按照以下步骤进行排查和解决：

1. 添加回调函数 (Callback) 监控下载进度

很多时候程序并没有真正“卡死”，而是因为网络波动或后台正在处理数据导致耗时较长。通过添加 callback 回调函数，你可以实时看到下载的进度和状态，从而判断程序是否还在运行。

修改后的代码示例：

from xtquant import xtdata
import time

def on_progress(data):
    # 打印下载进度信息
    print(f"下载进度回调: {data}")

code_list = ["000001.SZ"]
print("开始下载财务数据...")

# 传入 callback 参数
xtdata.download_financial_data(code_list, callback=on_progress)

print("下载指令已发送，等待完成...")

如果回调函数有持续输出，说明只是下载速度慢；如果没有任何输出且一直阻塞，请继续往下排查。

2. 检查 QMT 客户端状态

xtdata 的数据下载依赖于本地运行的 QMT 终端（或 MiniQMT）。

• 确保终端已启动并登录：如果 QMT 终端未登录或掉线，下载请求可能会一直等待响应。
• 检查终端的数据接收状态：在 QMT 客户端右下角，查看网络连接和数据接收是否正常。有时行情 API 正常，但财务数据服务器连接存在异常。

3. 异步调用与主线程阻塞

在某些版本的 xtdata 中，下载函数可能是阻塞的。如果你在 GUI 程序（如 PyQt/Tkinter）或某些特定的事件循环中调用它，可能会导致主线程假死。
解决方案：尝试将下载任务放入单独的线程中执行。

import threading
from xtquant import xtdata

def download_task():
    code_list = ["000001.SZ"]
    print("线程：开始下载...")
    xtdata.download_financial_data(code_list)
    print("线程：下载完成！")

# 创建并启动线程
t = threading.Thread(target=download_task)
t.start()

4. 清理本地缓存数据

有时本地的财务数据文件损坏或索引错误，会导致读取/写入时发生死锁。
解决方案：

1. 关闭 QMT 客户端和 Python 脚本。
2. 找到 QMT 安装目录下的 userdata_mini 或 userdata 文件夹。
3. 备份并删除其中的财务数据缓存文件夹（通常在 datadir 相关的路径下）。
4. 重启 QMT 客户端，再次尝试运行脚本。

5. 检查版本兼容性

确保你使用的 xtquant 库版本与本地安装的 QMT 客户端版本相匹配。如果 QMT 客户端进行了升级，而 Python 环境中的 xtquant 还是旧版本，可能会出现底层通信协议不一致导致的 Hang 死现象。

• 联系券商或迅投官方获取最新版本的 xtquant 安装包进行更新。

总结

建议首先加上 callback 回调函数来确认底层是否在工作。如果确认完全无响应，大概率是 QMT 客户端的财务数据服务未就绪或本地缓存冲突，重启客户端并清理缓存通常能解决 90% 的此类问题。