常见问题排查

Q: 提示 "credential is empty" 或认证失败？

1. 检查是否已配置凭证：pai config list（敏感字段会脱敏显示，但能看到是否为空）

2. 检查 AccessKey 是否有效：在阿里云控制台 → RAM 访问控制 → 用户 → 管理 AccessKey 中确认

3. 如果使用环境变量，确认 PAI_ACCESS_KEY_ID 和 PAI_ACCESS_KEY_SECRET 已正确设置

4. 如果使用 ECS RAM Role，确认实例已绑定 RAM 角色且 credential_type 设为 ecs_ram_role

Q: 如何在不同账号间切换？

# 使用 Profile 切换
pai dsw instance list --profile dev
pai dsw instance list --profile prod

Q: exec / cp 命令提示 "connection refused" 或超时？

1. 确认实例状态为 Running：pai dsw instance get <instance-id>

2. 检查通道类型：默认使用 gateway 通道，如果实例未开启公网访问，可能需要使用 VPC 通道

3. 尝试切换通道：pai dsw instance exec --via vpc <instance-id> -- echo ok

4. 使用 --debug 查看详细网络请求日志，定位具体错误

Q: 在 DSW 实例内部如何使用 pai？

DSW 实例内已预装 pai CLI，通常可直接运行 pai 命令而无需配置 AccessKey。当实例已绑定实例 RAM 角色时，CLI 会通过实例 metadata server 自动获取临时鉴权信息，并以实例 Owner 的身份和权限执行命令（详见配置管理 — 凭证配置中的免 AK/SK 提示）。若实例未绑定 RAM 角色，仍需通过 pai config set 或环境变量配置凭证。

Q: 创建实例时提示 "resource is not enough"？

1. 查看该规格的可用性：pai dsw instance list-ecs-specs --accelerator-type GPU，关注 is_available 字段

2. 尝试切换地域或可用区：--region cn-shanghai

3. 尝试使用抢占式实例（价格更低但可能被回收）：在 --spot-spec 中配置

4. 如果是包年包月，检查资源配额是否充足：pai resource quota get <quota-id>

Q: 如何选择合适的镜像？

# 列出所有官方预设镜像
pai image list --type preset

# 列出自定义镜像
pai image list --type custom

镜像 ID 通常格式为 framework:version-gpu-pyversion-cuda-ubuntuversion，例如 pytorch:2.0.1-gpu-py310-cu118-ubuntu20.04。

Q: 如何查看命令实际发送的 API 请求？

# 加 --debug 查看完整 HTTP 请求/响应
pai dsw instance list --debug

# 使用 --dry-run 预览操作而不执行
pai dsw instance delete <instance-id> --dry-run

# 使用 --generate-skeleton 生成请求模板
pai dsw instance create --generate-skeleton

Q: 如何用 jq 处理 JSON 输出？

# 提取实例 ID 列表
pai dsw instance list -o json | jq '.[].instance_id'

# 过滤 Running 状态的实例
pai dsw instance list -o json | jq '.[] | select(.status == "Running")'

# 获取第一个实例的 ID
pai dsw instance list -o json | jq -r '.[0].instance_id'