Docker部署Python应用时mypy_extensions模块找不到问题求助

问题根源 #

你把mypy_extensions安装到了dev开发依赖组，但Docker运行环境默认不会安装dev依赖，而代码里直接导入了这个模块，导致运行时触发ModuleNotFoundError。另外，mypy_extensions本质是类型检查工具的辅助库，运行时其实不需要加载它。

解决方案 #

方案一：用TYPE_CHECKING隔离类型导入 #

把mypy_extensions的导入放在类型检查专用的代码块里，运行时不会执行这段导入逻辑：

from typing import TYPE_CHECKING

# 仅在mypy类型检查时才会执行下面的导入
if TYPE_CHECKING:
    from mypy_extensions import NamedArg

# 正常使用NamedArg的类型标注
def my_func(callback: Callable[[NamedArg(int, 'id')], str]) -> None:
    pass

方案二：用Python标准库替代NamedArg #

如果你的Python版本≥3.10，直接用标准库的ParamSpec和Concatenate实现带命名参数的Callable类型标注，完全不需要第三方依赖：

from typing import Callable, ParamSpec, Concatenate

# 定义参数规范
P = ParamSpec('P')
# 标注接受一个int类型的id参数，以及其他任意命名参数，返回str的回调函数
def my_func(callback: Callable[Concatenate[NamedArg(int, 'id'), P], str]) -> None:
    callback(id=123, name="test")

方案三：将依赖移到主环境（不推荐） #

如果必须保留运行时导入，可以把mypy_extensions从dev组移到主依赖：

poetry remove mypy-extensions --group dev
poetry add mypy-extensions

但这种方法会把开发工具依赖带入生产环境，非必要不建议使用。

额外检查 #

确认Dockerfile里的依赖安装命令：如果用poetry install --no-dev，只会安装主依赖；如果需要临时包含dev依赖调试，可以改成poetry install，但生产环境务必用--no-dev。

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