Anaconda Prompt中某Conda环境执行Uvicorn命令提示“Access is denied”排查

关于依赖的补充说明 #

FastAPI核心依赖确实是fastapi和uvicorn，但Uvicorn自身依赖多个底层库（如click、colorama、httptools、websockets等），这些依赖的损坏、版本不兼容或缺失都可能触发权限报错。

排查与解决方向 #

• 验证Uvicorn命令本身的可执行性
  先执行简单命令确认是否是命令本身的问题：

  uvicorn --version
  

  如果同样报错，尝试用Python模块调用方式绕开可执行脚本：

  python -m uvicorn main:app --reload
  

  若模块调用能正常运行，说明Uvicorn的可执行脚本存在权限问题或损坏，直接强制重装Uvicorn即可：

  pip install uvicorn --force-reinstall
  

• 对比两个环境的依赖差异
  导出两个环境的完整依赖列表并对比：

  1. 正常环境导出：

     conda list --export > good_env.txt
     

  2. 异常环境导出：

     conda list --export > bad_env.txt
     

  3. 对比两个文件（Windows用fc good_env.txt bad_env.txt，Linux/macOS用diff good_env.txt bad_env.txt），重点检查Uvicorn的依赖包（如click、uvloop、httptools等）是否存在版本不一致、缺失或损坏的情况，发现差异后在异常环境中安装匹配版本。

• 检查Uvicorn可执行文件的权限与路径

  1. 分别在两个环境中查找Uvicorn的可执行路径：
     Windows：

     where uvicorn
     

     Linux/macOS：

     which uvicorn
     

  2. 对比两个路径下文件的权限设置：
     • Windows：右键文件→属性→安全，确认当前用户有读取和执行权限；也可使用icacls <uvicorn路径>查看权限详情。
     • Linux/macOS：使用ls -l <uvicorn路径>检查文件的执行权限（是否有x标识）。

• 排查conda环境本身的异常

  1. 检查异常环境的自定义脚本：查看环境目录下的etc/conda/activate.d和etc/conda/deactivate.d文件夹，确认没有修改PATH或权限相关的异常脚本。
  2. 创建全新测试环境：

     conda create -n test_env python=<你的Python版本>
     conda activate test_env
     pip install fastapi uvicorn
     uvicorn main:app --reload
     

     若新环境能正常运行，说明原异常环境已损坏，建议重建环境。

• Windows特殊情况排查

  • 检查异常环境的路径是否包含特殊字符（如空格、中文），部分工具对特殊路径的兼容性较差。
  • 临时关闭杀毒软件或防火墙，确认是否有程序拦截了Uvicorn的可执行文件。

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