macOS更新后Docker构建失败求助（sparse-dot-topn编译错误）

• 锁定兼容版本的sparse-dot-topn
  三周前能正常运行说明当时使用的版本是稳定的，现在构建失败大概率是requirements.txt未指定版本号，导致自动拉取了移除raw_doc成员的新版本。直接在requirements.txt中指定之前可用的稳定版本，比如：

  sparse-dot-topn==0.3.1
  

  若不确定具体版本，可查看本地历史依赖记录，或尝试0.3.x系列的版本。

• 清理Docker构建缓存
  旧构建缓存可能残留不完整的编译文件，干扰新依赖安装。重新构建时添加--no-cache参数强制清理：

  docker build --no-cache -t your-image-name .
  

• 检查关联依赖版本
  sparse-dot-topn编译依赖numpy和cython，若这两个库版本被自动更新，也可能引发兼容性问题。可同时锁定它们到三周前的可用版本，比如：

  numpy==1.24.3
  cython==0.29.36
  

• 本地验证（可选）
  若上述方法无效，先在本地Mac环境手动安装指定版本的sparse-dot-topn，确认编译正常后再构建Docker镜像：

  pip install sparse-dot-topn==0.3.1 --no-cache-dir
  

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