无明文输入时EVP_EncryptFinal_ex返回错误但可获取正确AES-GCM标签的问题排查

这个问题其实是OpenSSL EVP接口在AES-GCM模式下的预期行为，核心是对EVP_EncryptFinal_ex返回值的理解偏差，以及无明文场景下的特殊处理逻辑。

为什么EVP_EncryptFinal_ex返回0却能拿到正确标签？ #

GCM属于AEAD算法，加密流程分为处理附加认证数据（AAD）、处理明文生成密文和标签两部分。当没有明文需要加密时：

1. 你仅调用EVP_EncryptUpdate处理了AAD（甚至连明文相关的EVP_EncryptUpdate都没调用），此时EVP_EncryptFinal_ex没有任何密文数据需要处理——而GCM本身不需要填充，这个函数没有实际工作可做。
2. OpenSSL的实现中，这种场景下EVP_EncryptFinal_ex会返回0，但这不是错误——它只是表示“没有数据需要进入Final阶段处理”，而非加密操作失败。

错误信息为空的原因 #

你看到的error:00000000:lib(0):func(0):reason(0)，本质是因为ERR_get_error()返回了0，说明根本没有错误发生。这个返回值只是OpenSSL在“无数据可处理”时的特殊标记，并非失败信号。

正确的代码处理逻辑 #

你需要调整错误判断逻辑，区分“真失败”和“无数据可处理”的情况：

1. 调用EVP_EncryptFinal_ex后，先获取错误码ERR_get_error()
2. 只有当返回值<=0且错误码不为0时，才判定为真正的失败
3. 无论返回值如何，只要没有错误，就可以正常获取标签

修改后的代码示例：

int ret = EVP_EncryptFinal_ex(ctx, outbuf + outlen, &outlen);
unsigned long err_code = ERR_get_error();

// 仅当返回值失败且存在实际错误时，才抛出异常
if (ret <= 0 && err_code != 0) {
    printf("EVP_EncryptFinal_ex failed - OpenSSL error: %s", ERR_error_string(err_code, nullptr));
    return -1;
}

// 正常获取标签
if (!EVP_CIPHER_CTX_ctrl(ctx, EVP_CTRL_AEAD_GET_TAG, 16, tag)) {
    printf("EVP_CIPHER_CTX_ctrl: failed\n");
    return -1;
}

补充说明 #

OpenSSL官方文档在这部分的描述确实不够明确，尤其是针对“仅认证AAD无明文”的边缘场景。不过这个行为是稳定的，只要你按照“错误码+返回值”结合判断，就能正确处理这种情况。

内容的提问来源于stack exchange，提问作者cpp_enthusiast