Werkzeug版本兼容问题：flask-caching反序列化Redis缓存时出错

• 核心原因是Redis中存储的旧缓存数据使用了与当前环境不兼容的werkzeug模块结构进行序列化：
  • 最初写入缓存时，使用的werkzeug版本中，相关对象（如Headers）的模块路径为werkzeug.datastructures.headers；
  • 当前固定的werkzeug 2.2.2中，缓存数据的pickle序列化字符串记录的模块路径与环境实际结构不匹配，导致cachelib在反序列化时无法找到对应模块，触发No module named 'werkzeug.datastructures.headers'错误。
• 其次，flask-caching 2.0.1与werkzeug 2.2.2可能存在序列化逻辑的兼容bug，底层cachelib的反序列化逻辑未适配werkzeug的模块结构细节。

1. 清理旧缓存数据（最直接有效） #

旧缓存是问题根源，直接清理Redis中对应缓存键或整个缓存库：

# 清理当前Redis数据库的所有缓存（按需执行，避免误删其他数据）
redis-cli FLUSHDB

清理后应用会重新生成适配当前环境的缓存，错误即可消除。

2. 调整依赖版本组合 #

• 升级flask-caching到最新稳定版（如2.1.0及以上），新版本通常修复了与werkzeug的兼容问题：

pip install --upgrade flask-caching

• 若升级后仍有问题，可尝试降级werkzeug到flask-caching 2.0.1明确兼容的版本（如2.0.x系列），需确保同时兼容Flask 2.2.3。

3. 手动适配模块路径（无法清理缓存时使用） #

如果不能清理缓存，可在应用启动时添加模块路径兼容层，让pickle能找到正确的类：

import sys
from werkzeug.datastructures import Headers

# 创建模拟的旧模块路径，适配pickle反序列化逻辑
class MockHeadersModule:
    Headers = Headers

sys.modules['werkzeug.datastructures.headers'] = MockHeadersModule()

将这段代码放在Flask应用初始化的最前端（如app = Flask(__name__)之前），确保在cachelib执行反序列化前完成模块别名设置。

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