Go crypto/aes 怎样保留错误信息

Go crypto/aes 初始化失败时，使用 fmt.Errorf("操作说明: %w", err) 保留原始错误，再由上层通过 errors.As 识别 aes.KeySizeError。不要把错误替换成一个新的通用字符串，也不要为排障把密钥内容拼进错误或日志。

官方地址：https://pkg.go.dev/crypto/aes

先分清丢失的是哪一层信息

假设服务启动时创建加密模块，配置中的密钥字节数不符合要求。若封装函数只返回“初始化失败”，调用方知道操作失败，却无法区分配置长度问题与其他初始化问题。需要保留的有两部分：业务操作上下文，以及标准库错误的具体类型。

aes.NewCipher 接收的是原始密钥字节，要求长度为16、24或32字节。不要把十六进制或Base64表示的文本直接当成解码后的密钥；如果配置协议要求解码，解码错误属于更前面的配置处理阶段，应单独包装返回。字节数符合要求也不等于密钥来源、随机性和管理方式已经合适。

用%w保留原始错误

以下独立代码包只演示初始化与错误分类，不包含加密业务，也不硬编码可用密钥。NewBlock 的返回错误保留底层原因，InvalidKeyLength 负责取回长度信息。

package aesinit

import (
    "crypto/aes"
    "crypto/cipher"
    "errors"
    "fmt"
)

// NewBlock保留底层错误；固定上下文不包含密钥内容。
func NewBlock(key []byte) (cipher.Block, error) {
    block, err := aes.NewCipher(key)
    if err != nil {
        return nil, fmt.Errorf("初始化数据加密模块: %w", err)
    }
    return block, nil
}

// InvalidKeyLength返回长度错误携带的字节数，由内部调用方决定是否记录。
func InvalidKeyLength(err error) (int, bool) {
    var sizeErr aes.KeySizeError
    // 标准库返回的是KeySizeError值；这里传该变量的地址作为As目标。
    if errors.As(err, &sizeErr) {
        return int(sizeErr), true
    }
    return 0, false
}

// Classify只输出有限分类，不输出密钥、明文或不受控错误字符串。
func Classify(err error) string {
    if err == nil {
        return "ok"
    }
    if _, ok := InvalidKeyLength(err); ok {
        return "invalid_key_length"
    }
    return "initialization_failed"
}

%w 建立可解包关系；如果改用 %v 或 errors.New(err.Error())，原始错误只剩文字，类型识别所需的关系会丢失。errors.As 可以穿过多层正确包装，不必限定调用方只能再加一层上下文。

aes.KeySizeError 是以整数为基础的错误类型，标准库返回的是它的值。这里声明 var sizeErr aes.KeySizeError 后传 &sizeErr；不要误写成寻找 *aes.KeySizeError，后者与标准返回值的类型不一致。int(sizeErr) 表示错误携带的长度，不是密钥内容。

保留类型后，上层怎样作出判断

用 errors.Is(err, aes.KeySizeError(某个长度)) 去枚举所有非法长度并不方便；识别这一类错误更适合用 As。也不要在长度不合格时自动截断、补零或切换到其他密钥。这会改变配置含义，掩盖原始问题；应中止当前初始化并修正密钥配置。

不要把所有加密异常都归为KeySizeError

NewCipher 的错误属于创建分组密码对象的阶段。返回的 cipher.Block.Encrypt 和 Decrypt 没有 error 返回值，调用者需要遵守分组长度、目标缓冲区及重叠范围等契约；不能指望同一套返回错误包装接住所有调用违约。

若业务使用GCM，构造AEAD与 Open 的错误又是各自的阶段。认证失败不能被解释成“密钥长度不对”，更不能仅凭一次认证失败断定具体是密钥、密文、nonce还是附加数据不匹配。本文只建立初始化错误的保留方式，不把分组原语当作完整的加密协议。

内部诊断与对外响应分别设计

内部诊断可记录有限错误分类、模块名和请求关联号；经权限和数据策略允许后，才考虑记录失败长度。密钥内容、完整配置、明文和原始请求不应因为“保留错误”而被输出。包装的上下文也应采用固定操作名，避免把敏感参数放进错误链。

对外提示可以保持统一，由请求关联号连接内部诊断。若密钥来自服务端配置，错误归属通常是服务配置，不能机械地归咎客户端输入。是否向外暴露细节，由接口契约决定，不必直接回传 err.Error()。

采用这种写法时，维护者获得可识别原因，模块调用方获得操作上下文，外部使用者获得稳定提示。观察已有系统是否仍把初始化错误压成字符串、是否存在重复记录或敏感参数拼接，就能确定改造重点；这不依赖虚构的行业采用率或性能收益。

相关问题

多包几层会失去KeySizeError吗？每层都正确保留可解包原因时，As仍能查找；中间某层转成纯字符串则会断开。

长度合法就一定能解密吗？不能。它只满足AES密钥长度要求，不能证明密钥值、协议参数或认证输入匹配。

需要recover处理普通长度错误吗？不需要。NewCipher的长度错误按返回值处理；recover不能替代调用契约和正常错误分支。

技术依据：crypto/aes、errors.As、crypto/cipher、AES初始化实现。