

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 排除常见设置问题
<a name="mlflow-troubleshooting"></a>

了解常见的故障排除问题。

## 找不到名为“groff”的可执行文件
<a name="mlflow-troubleshooting-groff"></a>

使用 AWS CLI 时，您可能会遇到以下错误：`Could not find executable named 'groff'`。

如果使用 Mac，您可以使用以下命令解决这个问题：

```
brew install groff
```

在 Linux 机器上，使用以下命令：

```
sudo apt-get update -y
sudo apt-get install groff -y
```

## 未找到命令：jq
<a name="mlflow-troubleshooting-jq"></a>

创建 AuthZ 权限策略 JSON 文件时，您可能会遇到以下错误：`jq: command not found`。

如果使用 Mac，您可以使用以下命令解决这个问题：

```
brew install jq
```

在 Linux 机器上，使用以下命令：

```
sudo apt-get update -y
sudo apt-get install jq -y
```

## AWS MLflow 插件的安装速度
<a name="mlflow-troubleshooting-speeds"></a>

安装 AWS 使用 Mac Python 环境时，安装 MLflow 插件可能需要几分钟时间。

## UnsupportedModelRegistryStoreURIException
<a name="mlflow-troubleshooting-uri-exception"></a>

如果您看到 `UnsupportedModelRegistryStoreURIException`，请执行以下操作：

1. 重启 Jupyter Notebook 内核。

1. 重新安装 AWS MLflow 插件：

   ```
   !pip install --force-reinstall sagemaker-mlflow
   ```