如何在nixpkgs中用overlay完全替换Python模块flask-limiter

常见问题排查与修复 #

1. 确保Overlay覆盖到正确的路径 #

很多时候是覆盖层级不对——你得同时处理对应Python版本的包集合，以及顶层的包入口（如果要直接nix-env -i安装的话）。示例Overlay写法：

self: super: {
  # 先覆盖python310的包集合
  python310 = super.python310.override {
    packageOverrides = pythonSelf: pythonSuper: {
      flask-limiter = pythonSelf.callPackage ./your-flask-limiter.nix {};
    };
  };
  # 让顶层的flask-limiter指向自定义版本
  flask-limiter = self.python310Packages.flask-limiter;
}

2. 检查callPackage的参数是否匹配 #

你的自定义脚本缺参数会报错，说明callPackage没法自动注入所需依赖。要么确保.nix文件参数和nixpkgs原包一致，要么直接基于原包修改减少参数问题：

# your-flask-limiter.nix 示例写法，继承原包参数
{ lib, buildPythonPackage, fetchPypi, flask, limits, ... }:
buildPythonPackage rec {
  pname = "flask-limiter";
  version = "自定义版本号";
  src = fetchPypi {
    inherit pname version;
    hash = "对应src的哈希值";
  };
  propagatedBuildInputs = [ flask limits ];
  # 在这里写自定义构建逻辑，比如修改setup.py、添加补丁等
}

3. 验证Overlay是否真的被加载 #

先验证Overlay是否生效，别直接安装：

nix-env -qaP flask-limiter -f /path/to/your/nixpkgs-with-overlay.nix

如果输出里的包路径还是nixpkgs官方的，说明Overlay没被正确加载——检查是否用了正确的nixpkgs源，或者用临时加载方式测试：

nix-shell -p flask-limiter --arg overlays '[./your-overlay.nix]'

进shell后用pip show flask-limiter查看版本是否为自定义版本。

4. 清理旧缓存 #

Nix的缓存有时候会顽固保留旧包，清理后再重新安装：

# 删除已安装的flask-limiter及其依赖
nix-store --delete $(nix-store -qR $(nix-env -q flask-limiter))
# 清理无用存储对象
nix-collect-garbage -d

5. 反向依赖的Python版本要对应 #

如果是通过其他依赖间接安装，得确认那个依赖用的Python版本和你覆盖的一致。比如依赖用的是python310Packages，那你必须覆盖python310Packages.flask-limiter，而非其他Python版本的包集合。

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