部署到Heroku的Dash-Plotly Python应用出现间歇性KeyError问题

问题根因 #

你遇到的间歇性KeyError本质是类实例的数据加载存在竞态条件，和Heroku的运行机制直接相关：

• Heroku默认会启动多个Gunicorn worker进程处理请求，每个worker是独立的进程空间，如果你把class_name的初始化逻辑放在全局作用域或者懒加载位置，不同worker的初始化进度不一致：当请求落到还没完成Excel读取、或者读取中断的worker上时，product字典的键就会缺失，落到已经完成初始化的worker上就运行正常，这就是报错随机、多点几次就能成功的核心原因——多点几次请求会被负载均衡分配到不同worker，总会落到初始化完成的worker上。
• 你之前移除了全局变量但没解决问题，大概率是你把Excel读取逻辑写在了class的构造函数、或者Dash表单生成的回调里，这些逻辑本身没有做原子性校验，部分场景下读取Excel还没走完就返回了不完整的product字典。

解决方案 #

按优先级从高到低尝试：

1. 把Excel读取逻辑移到应用启动的最前置位置，强制同步完成后再启动服务
   在你的Dash入口文件最开头就完成所有产品类的初始化、Excel读取操作，加校验逻辑确保所有product字典的必要键都存在后再启动app，不要把读取逻辑放在回调或者懒加载位置。示例参考：

   # 入口文件app.py最开头
   import pandas as pd
   # 预加载所有Excel数据
   ALL_PRODUCT_DATA = {}
   for class_type in [M, B, ...]: # 替换为你的所有产品类
       df = pd.read_excel("./data/productspec.xlsx")
       # 强制校验所有列存在
       required_cols = ["freq-low", "freq-high", "rf-low", ...] # 把所有需要的键列出来
       for col in required_cols:
           assert col in df.columns, f"缺失必要列{col}"
       # 转成字典存入全局常量，后续所有回调直接读这个常量，不要重复读Excel
       ALL_PRODUCT_DATA[class_type] = df.to_dict("records")
   
   # 后面再初始化Dash app、写回调逻辑
   

2. 调整Heroku的Gunicorn启动参数，先完成预加载再fork worker
   你项目根目录的Procfile里修改启动命令，加上--preload参数，让Gunicorn在fork出多个worker前就完成所有全局代码的加载，确保所有worker拿到的都是完整的初始化数据：

   web: gunicorn --preload app:server -w 2 # 替换为你自己的app入口
   

3. 临时兜底：给字典取值加容错
   改search_products里的取值逻辑，避免直接product['xxx']抛错，就算出现数据不完整的情况也不会直接崩：

   # 把原来的判断改成get取值，不存在的话直接跳过该条产品
   elif (low == None or (product.get('freq-low', float('inf')) <= low and high <= product.get('freq-high', float('-inf')))):
   

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