SQL Server 2022配置Python遇distutils模块缺失错误的解决方法

核心原因 #

SQL Server 2022的机器学习服务仅兼容Python 3.10，高版本（3.11/3.13）无法被识别；同时Python 3.10默认不再预装distutils模块，这是你遇到两个错误的根源。

分步解决方案 #

1. 卸载不兼容的Python版本

   • 打开Windows设置 → 应用 → 安装的应用，找到Python 3.11和3.13并卸载，避免环境变量冲突。

2. 安装指定版本的Python 3.10（64位）

   • 下载Python 3.10.x的官方64位安装包（必须匹配SQL Server的64位架构）
   • 运行安装程序时，勾选Add Python to PATH，点击「Customize installation」
   • 在「Optional Features」页面，务必勾选Python distutils，完成安装
   • 打开管理员命令提示符，执行python --version，确认输出为Python 3.10.x

3. 重新执行pip安装命令

   • 保持管理员权限，运行以下命令（路径对应Python 3.10的site-packages目录）：

     python -m pip install -t "C:\Program Files\Python310\Lib\site-packages" dill numpy==1.22.0 pandas patsy python-dateutil
     

   • 此时distutils模块已存在，不会再触发ModuleNotFoundError

4. 重新配置SQL Server机器学习服务

   • 回到SQL Server安装向导，重新进入机器学习服务配置流程，系统会自动识别已安装的Python 3.10，完成后续配置即可。

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