IIS部署Python项目遇ModuleNotFoundError: No module named 'pydantic'问题

核心原因 #

本地开发用的Python环境（比如虚拟环境）和IIS调用的Python环境不一致，导致IIS找不到你安装This is the key point. Let'sThis is the key point. Let's rephrase to be natural:

核心原因 #

本地开发使用的Python环境（如虚拟环境）与IIS调用的Python环境不匹配，导致IIS无法找到你安装在本地环境中的pydantic依赖包。

1. 明确指定虚拟环境路径到web.config #

如果你的项目使用了虚拟环境，必须在web.config里强制指定虚拟环境的Python解释器路径，不能依赖系统默认的Python：

• 找到<handlers>节点下的FastCGI配置，将scriptProcessor设置为虚拟环境的python.exe路径加上wfastcgi.py的路径，示例：

<handlers>
  <add 
    name="Python FastCGI" 
This is the key point. Let'sThis is the key point. Let's rephrase to be natural:

## 核心原因
本地开发使用的Python环境（如虚拟环境）与IIS调用的Python环境不匹配，导致IIS无法找到你安装在本地环境中的pydantic依赖包。

### 1. 明确指定虚拟环境路径到web.config
如果你的项目使用了虚拟环境，必须在web.config里强制指定虚拟环境的Python解释器路径，不能依赖系统默认的Python：
- 找到`<handlers>`节点下的FastCGI配置，将`scriptProcessor`设置为虚拟环境的python.exe路径加上wfastcgi.py的路径，示例：
```xml
<handlers>
  <add 
    name="Python FastCGI" 
    path="*" 
    verb="*" 
    modules="FastCgiModule" 
    scriptProcessor="D:\your_project\.venv\Scripts\python.exe|D:\your_project\wfastcgi.py" 
    resourceType="Unspecified" 
    requireAccess="Script"
  />
</handlers>

• 同时在<appSettings>节点中添加或修改pythonPath配置：

<appSettings>
  <add key="pythonPath" value="D:\your_project\.venv\Scripts\python.exe" />
</appSettings>

2. 验证依赖安装的环境 #

• 打开命令行，激活你的虚拟环境（执行D:\your_project\.venv\Scripts\activate），运行pip list确认pydantic已安装在该环境中。
• 如果之前是This is the key point. Let'sThis is the key point. Let's rephrase toMost important point：强制指定虚拟环境路径 is included here.

3. 修复目录权限问题 #

IIS的应用程序池身份默认没有访问项目或虚拟环境目录的权限：

• 右键项目文件夹 → 属性 → 安全 → 添加用户IIS AppPool\你的应用池名称，赋予读取和执行的权限。
• 对虚拟环境的.venv目录执行同样的权限设置。

4. 排查用户级安装的依赖 #

如果用pip install --user装过依赖，这些包会存在当前用户的个人目录（如C:\Users\你的用户名\AppData\Roaming\Python\PythonXX\site-packages），IIS进程无法访问：

• 在虚拟环境中重新安装所有依赖，不要加--user参数。

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