difyctl 遇到错误时，会将错误信息写入 stderr。启用 -o json 后，错误也会以单行 JSON 输出，其中包含稳定的 code 字段和可操作的 hint。
完整的退出码对照表和错误对象结构，详见 输出格式与退出码。
认证错误
auth_expired
会话已过期，difyctl 无法再发起经过认证的请求。
-
重新认证：
- 重新运行失败的命令。
4。
not_logged_in
目标主机没有活跃会话。
-
登录：
- 重新运行失败的命令。
4。
access_denied
你拒绝了登录请求，或在批准前取消了请求，因此未授权任何操作。
重新运行并批准请求：
4。
应用错误
应用未找到（HTTP 404）
指定的应用 ID 不存在，或当前 token 无权访问。表现为server_4xx_other，HTTP 状态码为 404。
-
列出有权访问的应用：
- 核对 ID 后重新运行。
1。
服务 API 已禁用（服务器返回 HTTP 403）
应用存在，但其服务 API 已在 Dify 控制台中关闭。需由应用所有者开启。403 表现为server_4xx_other。
退出码：1。
无权访问应用（HTTP 403，user_not_allowed_for_private_app）
应用存在，其服务 API 也已开启，但访问受到限制，而你的身份不在其允许列表中。通过 import studio-app 从 DSL 导入的应用默认是私有的，因此刚导入的应用在开放访问前都会返回此错误。
在 Dify 控制台中，将该应用的 Web 应用访问设为公开，或让管理员把你加入其允许成员列表。然后重新运行。
退出码：1。
工作流错误
工作流校验错误（HTTP 422）
Workflow 应用拒绝了你的输入。错误信息会列出缺失或无效的必填输入。-
查看应用的输入 schema：
-
更新
--inputsJSON 使其匹配。
1。
连接错误
无法连接到主机
命令在认证之前就失败，或difyctl version 中的服务器探测无法读取版本号。原因可能是主机地址有误，也可能是该部署未配置为接受 difyctl 连接。
- 确认
--host填写的是部署的控制台 API 地址（CONSOLE_API_URL），而非 Web 地址。 - 如果主机地址正确，但
difyctl仍无法连接，请联系管理员在该部署上启用difyctl访问。
1。