如何在Go语言微服务中设计非对称加密的API通信报文-Golang-PHP中文网

rsa不能直接加密http body，因其明文长度严格受限（如2048位密钥仅支持约245字节），而api json报文常达数百上千字节，直接加密会报“message too long”错误；真实方案是混合加密：客户端用服务端rsa公钥加密随机生成的aes密钥，再用该aes密钥加密json payload，打包version、keyenc、payloadenc、nonce、tag等字段构成安全可扩展的结构体，并在服务端严格校验版本、密钥长度、nonce/tag长度及gcm认证通过后才解密。

如何在go语言微服务中设计非对称加密的api通信报文

为什么不能直接用RSA加密HTTP body

因为RSA有严格长度限制：1024位密钥最多加密117字节，2048位也只支持245字节左右。微服务API的JSON body动辄几百上千字节，直接调用 rsa.EncryptPKCS1v15 会报 crypto/rsa: message too long for RSA key size 错误。

真实场景里，你不是用RSA去“加密整个请求”，而是用它来安全传递一个临时对称密钥——这个思路叫“混合加密”。

客户端生成随机AES密钥（比如32字节）
用服务端公钥加密这个AES密钥，得到密文 aes_key_encrypted
用该AES密钥加密原始JSON payload，得到 payload_encrypted
把两个密文、IV、Nonce等一起打包成结构体发送

报文结构怎么定义才够安全又可扩展

别用裸JSON拼字段，定义明确的加密报文结构体。关键字段必须包含：

type EncryptedRequest struct {
    Version     string `json:"v"`        // 协议版本，便于未来升级
    KeyEnc      []byte `json:"k"`        // RSA加密后的AES密钥
    PayloadEnc  []byte `json:"p"`        // AES-GCM加密后的payload
    Nonce       []byte `json:"n"`        // AES-GCM需要的nonce（12字节）
    Tag         []byte `json:"t"`        // GCM认证标签（16字节）
}

注意：Version 字段不能省——不同服务可能升级到AES-256-GCM或ChaCha20-Poly1305，靠它做路由和解密策略分发；Tag 必须显式传输，GCM模式下缺它就无法验证完整性。

不要把公钥或算法名塞进body里。这些属于通信契约，应由服务发现或配置中心统一管理，避免每次请求都重复传输冗余信息。