华为云CodeArts CLI踩坑记：认证失败了，退出码为什么还是0？

前言

在上一篇里，我解决了crontab定时任务中CodeArts CLI认证失败的问题。但修好之后，我又发现了一个更隐蔽的坑——即便CLI认证失败了，进程的退出码（exit code）仍然是 0。

如果你像我一样，习惯于通过 exit code 来判断命令执行是否成功，那这个"假阳性"很容易让你误以为一切正常，实际任务却什么都没完成。这篇文章就来聊聊这个问题以及怎么绕过去。

退出码的基础知识

先简单回顾一下Linux的退出码约定：

• 0 = 成功
• 非0 = 失败（具体含义因程序而异）

绝大多数命令行工具都遵循这个约定。比如：

$ ls /不存在的目录
ls: cannot access '/不存在的目录': No such file or directory
$ echo $?
2    # 非0，表示失败了

所以当我们写脚本时，很自然地会这样判断：

codearts run "问题"
if [ $? -eq 0 ]; then
    echo "✅ 执行成功"
else
    echo "❌ 执行失败"
fi

这个逻辑在绝大多数场景下没问题，但在CodeArts CLI这里翻车了。

问题现象

假设AK/SK没有正确配置，运行CLI：

$ codearts run "解释一下什么是变量"
● 认证失败，没有设置环境变量CODEARTS_CLI_AK/CODEARTS_CLI_SK
  请在华为云统一身份认证页面申请AK/SK，通过配置环境变量的方式使用cli命令。

$ echo $?
0    # ⚠️ 返回0！

看到没？明明输出明确写着"认证失败"，但 echo $? 打出来是 0。

如果你用Python调它：

import subprocess

result = subprocess.run(
    ["codearts", "run", "问题"],
    capture_output=True, text=True
)

if result.returncode == 0:
    print("✅ 执行成功")     # ← 会走这里！
    print(result.stdout)    # ← 但内容是"认证失败"
else:
    print("❌ 执行失败")

输出会是：

✅ 执行成功
● 认证失败，没有设置环境变量CODEARTS_CLI_AK/CODEARTS_CLI_SK
......

成功标志 + 错误内容，这就是"假阳性"——进程层面没有崩溃（正常输出了错误信息后退出），但业务层面是失败的。

为什么CLI这样设计？

从CLI开发者的角度看，这其实不算bug，而是一种设计选择：

• 进程本身运行正常——能正确检测到缺少环境变量、能输出错误提示，没有core dump
• 认证失败属于"业务错误"，不是"程序崩溃"
• 有些工具认为只要自己能正常跑完就应该返回0

但在使用者的角度，当认证失败时，我们期望它返回一个非0的 exit code，这样脚本才能抓到。

解决方案

既然CLI不会帮我们区分，那只能自己判断了：不要只依赖退出码，同时检查输出内容。

Shell脚本方案：

#!/bin/bash
OUTPUT=$(codearts run "你的问题" 2>&1)
EXIT_CODE=$?

if [ $EXIT_CODE -eq 0 ] && ! echo "$OUTPUT" | grep -q "认证失败"; then
    echo "✅ 执行成功"
    echo "$OUTPUT"
else
    echo "❌ 执行失败"
    echo "$OUTPUT"
    exit 1
fi

用 grep -q "认证失败" 检查输出内容，两者都通过才判成功。

Python方案：

import subprocess

def run_codearts(question, timeout=300):
    result = subprocess.run(
        ["codearts", "run", question],
        capture_output=True, text=True,
        timeout=timeout
    )

    # 先看退出码
    if result.returncode != 0:
        return False, f"进程异常: {result.stderr}"

    stdout = result.stdout

    # 再看内容，检查认证失败关键字
    auth_fail_keywords = ["认证失败", "没有设置环境变量"]
    if any(kw in stdout for kw in auth_fail_keywords):
        return False, f"认证失败: {stdout[:200]}"

    # 退出码正常 + 内容无异常 = 真正成功
    return True, stdout

关键思路：exit code 和输出内容，两个维度都要检查。exit code 保证进程没崩，输出内容保证业务没出错。

不只是CodeArts CLI的问题

这个问题其实在很多CLI工具中都存在：

所以"exit code + 内容校验"的双重检查模式是一个通用的稳健方案，不只是针对CodeArts CLI。

总结

两者互补。对于CodeArts CLI这种"认证失败也返回0"的情况，务必备份一份输出内容的检查逻辑。不然你的自动化脚本可能会在对你说"一切正常"的同时，实际什么都没干。

下一篇来聊聊第三个坑——偶发的网络超时问题。