故障排除#

此页面详细介绍了一些常见问题及其相应的解决方法。有关 Anaconda 安装或技术支持选项，请访问我们的 支持产品页面.

提示

您可以使用浏览器的搜索功能 (Ctrl/Cmd + F) 搜索此页面以查找信息。

Conda：频道不可用/丢失或包本身丢失#

原因

在 Pro 或 Business 层级配置您的 .condarc 后，在某些情况下，您可能无法安装包。您可能会收到一条错误消息，指出频道或包不可用或丢失。

解决方案

对于所有这些问题，一个可能的解决方法是运行以下命令

conda clean -i

这将清除“索引缓存”并强制 conda 从仓库服务器同步元数据。

403 错误#

原因

403 错误是 Web 服务器在客户端被禁止访问资源时发出的通用禁止错误。

您收到的 403 错误可能类似于以下内容

Collecting package metadata (current_repodata.json): failed

UnavailableInvalidChannel: The channel is not accessible or is invalid.
  channel name: pkgs/main
  channel url: https://repo.anaconda.com/pkgs/main
  error code: 403

You will need to adjust your conda configuration to proceed.
Use `conda config --show channels` to view your configuration's current state,
and use `conda config --show-sources` to view config file locations.
There are several reasons a 403 error could be received:

收到此错误的可能原因有以下几种

  • 用户在配置中错误地配置了他们的频道（例如，意外删除了存储令牌的安全位置（最常见）

  • 防火墙或其他安全设备或系统阻止了用户访问（第二常见）

  • 由于潜在的服务条款违规，我们阻止了他们的访问（第三常见）

解决方案

  1. 首先，运行以下命令以撤消您的配置

    conda config --remove-key default_channels

    当 conda 首次安装时，它用于安装包的默认频道为 https://repo.anaconda.com/main 和 https://repo.anaconda.com/r（以及 https://repo.anaconda.com/msys2 用于 Windows 操作系统）。

  2. 如果您的其他频道需要令牌，请通过运行以下命令安装或升级 conda-token 工具

    conda install --freeze-installed conda-token

  3. 最后，重新应用令牌和配置设置

    # Replace <TOKEN> with your token
conda token set <TOKEN>

如果这不能解决问题，Anaconda 建议您咨询我们的 服务条款错误 页面。

HTTP 000 连接失败#

原因

这通常是由代理配置错误引起的，可以通过正确设置您的 代理服务器 来解决。但是，由于某些企业没有提供 SSL 证书的简便方法，因此 Anaconda 建议您在遇到此错误时绕过 SSL 验证步骤。

解决方案

如果您收到此错误消息，请先运行以下命令

conda config --set ssl_verify false

（包安全管理器用户）如果需要，请通过运行以下命令安装 conda-token

conda install conda-token -n base

（包安全管理器用户）通过运行以下命令确保令牌验证步骤忽略 SSL 错误

# Replace <TOKEN> with your token
conda token set --no-ssl-verify <TOKEN>

您可能会看到以下警告，尽管您可以安全地忽略它

/Users/<USERNAME>/Applications/miniconda3/lib/python3.7/site-packages/urllib3/connectionpool.py:1020: InsecureRequestWarning: Unverified HTTPS request is being made to host 'repo.anaconda.cloud'. Adding certificate verification is strongly advised. See: https://urllib3.readthedocs.io/en/latest/advanced-usage.html#ssl-warnings
InsecureRequestWarning,

环境创建由于策略过滤器而失败#

原因

实施严格的策略过滤器而没有例外可能会导致基本包依赖项从您的仓库中过滤掉。如果没有这些包，诸如 conda create --name <ENV_NAME> python=3.11 之类的命令将失败。

如果您尝试创建新环境，但您的构建因包冲突或包不可用而失败，则可能是由于您的 IT 团队的严格策略过滤器造成的。您可以要求将包例外添加到策略过滤器中，但您需要首先知道哪些包会导致问题。

解决方案

要执行此测试，您需要一个没有应用策略过滤器的通道。在您的组织中创建该通道，并将其命名为 quarantine。创建完成后，将其添加到您的 .condarc 文件中。有关将通道添加到 .condarc 文件的帮助，请参阅 通道。

创建并添加隔离通道到您的 .condarc 文件后，您可以运行以下命令

# Replace <ENV_NAME> with a test environment name (this is not permanent)
# Replace <CHANNEL> with your channel name
conda create --name <ENV_NAME> -c <CHANNEL> -c quarantine python=3.11 --dry-run

注意

如果您在 .condarc 中设置了通道别名，则可以使用通道名称和 -c（通道）参数。如果您没有设置，可以使用完整的通道 URL 和 -c（通道）参数。您可以从“通道”页面复制通道 URL。有关设置通道别名的更多信息，请参阅 使用 .condarc conda 配置文件。

例如，如果您尝试从 snakes 通道测试构建环境，则命令将是

conda create --name test_environment -c snakes -c quarantine python=3.11 --dry-run

注意

snakes 和 quarantine 的顺序至关重要。Conda 将尝试按通道列出的顺序解决环境，因此 quarantine 必须列在最后。

示例命令返回值

## Package Plan ##

    environment location: /Users/<USER>/opt/anaconda3/envs/test_env

    added / updated specs:
    - python=3.11

The following packages will be downloaded:

    package                    |            build
    ---------------------------|-----------------
    bzip2-1.0.8                |       h80987f9_5         129 KB  snakes
    ca-certificates-2023.12.12 |       hca03da5_0         127 KB  snakes
    libffi-3.4.4               |       hca03da5_0         120 KB  snakes
    ncurses-6.4                |       h313beb8_0         884 KB  quarantine
    openssl-3.0.13             |       h1a28f6b_0         5.0 MB  quarantine
    pip-23.3.1                 |  py311hca03da5_0         3.3 MB  quarantine
    python-3.11.8              |       hb885b13_0        15.5 MB  snakes
    readline-8.2               |       h1a28f6b_0         353 KB  snakes
    setuptools-68.2.2          |  py311hca03da5_0         1.2 MB  snakes
    sqlite-3.41.2              |       h80987f9_0         1.1 MB  quarantine
    tk-8.6.12                  |       hb8d0fd4_0         2.9 MB  snakes
    tzdata-2024a               |       h04d1e81_0         116 KB  snakes
    wheel-0.41.2               |  py311hca03da5_0         142 KB  quarantine
    xz-5.4.6                   |       h80987f9_0         372 KB  snakes
    zlib-1.2.13                |       h5a0b063_0          82 KB  quarantine
    ------------------------------------------------------------
                                   Total:        31.4 MB

The following NEW packages will be INSTALLED:

    bzip2              snakes/osx-arm64::bzip2-1.0.8-h80987f9_5
    ca-certificates    snakes/osx-arm64::ca-certificates-2023.12.12-hca03da5_0
    libffi             snakes/osx-arm64::libffi-3.4.4-hca03da5_0
    ncurses            quarantine/osx-arm64::ncurses-6.4-h313beb8_0
    openssl            quarantine/osx-arm64::openssl-3.0.13-h1a28f6b_0
    pip                quarantine/osx-arm64::pip-23.3.1-py311hca03da5_0
    python             snakes/osx-arm64::python-3.11.8-hb885b13_0
    readline           snakes/osx-arm64::readline-8.2-h1a28f6b_0
    setuptools         snakes/osx-arm64::setuptools-68.2.2-py311hca03da5_0
    sqlite             quarantine/osx-arm64::sqlite-3.41.2-h80987f9_0
    tk                 snakes/osx-arm64::tk-8.6.12-hb8d0fd4_0
    tzdata             snakes/noarch::tzdata-2024a-h04d1e81_0
    wheel              quarantine/osx-arm64::wheel-0.41.2-py311hca03da5_0
    xz                 snakes/osx-arm64::xz-5.4.6-h80987f9_0
    zlib               quarantine/osx-arm64::zlib-1.2.13-h5a0b063_0

DryRunExit: Dry run. Exiting.

从 quarantine 通道检索到的软件包是需要在策略过滤器中考虑异常的软件包。

本页内容