在跨语言服务对接的场景中，使用AES加密保障数据传输安全是常见选择，但Go和Ruby的AES实现默认逻辑存在差异，很容易出现一方加密的结果另一方无法解密的问题，其中密钥长度配置不一致是最主要的诱因。
AES密钥长度的基础规范
AES算法本身支持三种长度的密钥，分别对应不同的加密强度：
- 128位密钥：对应AES-128模式，密钥长度为16字节
- 192位密钥：对应AES-192模式，密钥长度为24字节
- 256位密钥：对应AES-256模式，密钥长度为32字节
无论使用哪种开发语言，只要双方使用的密钥长度、加密模式、填充方式、初始化向量（IV）完全一致，加密结果就可以互通。很多开发者忽略的是，Go和Ruby对密钥长度的默认处理逻辑不同，比如Ruby的OpenSSL库默认不会对密钥做自动截断或填充，而Go的标准库在部分场景下会隐式处理密钥长度，这就会导致两端密钥实际长度不一致。
Go端AES加密配置实现
Go的标准库crypto/aes提供了AES加密的基础能力，我们需要在代码中显式指定密钥长度对应的模式，避免使用默认的不确定逻辑。以下是一个AES-256-CBC模式的加密示例，包含密钥长度校验和统一处理逻辑：
package main
import (
"crypto/aes"
"crypto/cipher"
"crypto/rand"
"encoding/base64"
"fmt"
"io"
)
// 加密函数，要求密钥长度为32字节（对应AES-256）
func aesEncrypt(plaintext, key, iv []byte) (string, error) {
// 校验密钥长度，不符合要求则返回错误
if len(key) != 32 {
return "", fmt.Errorf("密钥长度必须为32字节，当前长度为%d", len(key))
}
// 校验IV长度，CBC模式要求IV长度为16字节
if len(iv) != aes.BlockSize {
return "", fmt.Errorf("IV长度必须为%d字节，当前长度为%d", aes.BlockSize, len(iv))
}
block, err := aes.NewCipher(key)
if err != nil {
return "", err
}
// 明文填充，使用PKCS5Padding
padding := aes.BlockSize - len(plaintext)%aes.BlockSize
padtext := make([]byte, padding)
for i := 0; i < padding; i++ {
padtext[i] = byte(padding)
}
plaintext = append(plaintext, padtext...)
ciphertext := make([]byte, len(plaintext))
mode := cipher.NewCBCEncrypter(block, iv)
mode.CryptBlocks(ciphertext, plaintext)
return base64.StdEncoding.EncodeToString(ciphertext), nil
}
func main() {
// 原始密钥，若长度不足32字节则补0，超过则截断为32字节
rawKey := "my_secret_key_1234567890abcdef"
key := make([]byte, 32)
copy(key, []byte(rawKey))
// 生成16字节的随机IV
iv := make([]byte, aes.BlockSize)
if _, err := io.ReadFull(rand.Reader, iv); err != nil {
panic(err)
}
plaintext := "hello from go"
encrypted, err := aesEncrypt([]byte(plaintext), key, iv)
if err != nil {
panic(err)
}
fmt.Printf("加密结果：%s\n", encrypted)
fmt.Printf("IV（base64）：%s\n", base64.StdEncoding.EncodeToString(iv))
}Ruby端AES加密配置实现
Ruby中通常通过OpenSSL库实现AES加密，需要显式指定加密模式、密钥长度、填充方式，避免依赖默认值。以下是一个和Go端对应的AES-256-CBC模式加密示例：
require 'openssl'
require 'base64'
def aes_encrypt(plaintext, key, iv)
# 校验密钥长度，固定为32字节
if key.bytes.length != 32
raise "密钥长度必须为32字节，当前长度为#{key.bytes.length}"
end
# 校验IV长度，CBC模式要求16字节
if iv.bytes.length != 16
raise "IV长度必须为16字节，当前长度为#{iv.bytes.length}"
end
cipher = OpenSSL::Cipher.new('AES-256-CBC')
cipher.encrypt
cipher.key = key
cipher.iv = iv
# 使用PKCS5填充，和Go端保持一致
cipher.padding = 1
encrypted = cipher.update(plaintext) + cipher.final
Base64.encode64(encrypted).strip
end
# 原始密钥，和Go端保持一致的处理逻辑，补0或截断为32字节
raw_key = "my_secret_key_1234567890abcdef"
key = raw_key.ljust(32, "\0")[0, 32]
# IV需要和Go端加密时使用的IV一致，这里用Go端生成的IV做示例
iv = Base64.decode64("这里填入Go端输出的IV base64字符串")
plaintext = "hello from go"
begin
encrypted = aes_encrypt(plaintext, key, iv)
puts "加密结果：#{encrypted}"
rescue => e
puts "加密失败：#{e.message}"
end互操作问题的排查要点
如果两端加密结果仍然无法互通，可以按照以下顺序排查：
- 确认密钥长度完全一致，可通过输出密钥的字节长度验证
- 确认加密模式一致，比如都使用CBC、GCM等，不要用Go的默认模式搭配Ruby的另一种模式
- 确认填充方式一致，PKCS5和PKCS7在AES场景下的实现是一致的，但若一端用NoPadding另一端用PKCS5就会出错
- 确认IV完全一致，IV不需要保密，但两端必须使用同一个IV，且长度符合对应模式的要求
- 确认编码方式一致，加密结果传输时使用相同的编码，比如都使用Base64，避免二进制数据在传输中失真
解密端的对应实现
互操作不仅要求加密结果一致，解密也需要对应配置，Go端解密示例：
func aesDecrypt(encryptedStr string, key, iv []byte) (string, error) {
if len(key) != 32 {
return "", fmt.Errorf("密钥长度必须为32字节，当前长度为%d", len(key))
}
if len(iv) != aes.BlockSize {
return "", fmt.Errorf("IV长度必须为%d字节，当前长度为%d", aes.BlockSize, len(iv))
}
ciphertext, err := base64.StdEncoding.DecodeString(encryptedStr)
if err != nil {
return "", err
}
block, err := aes.NewCipher(key)
if err != nil {
return "", err
}
if len(ciphertext)%aes.BlockSize != 0 {
return "", fmt.Errorf("密文长度不是块大小的整数倍")
}
plaintext := make([]byte, len(ciphertext))
mode := cipher.NewCBCDecrypter(block, iv)
mode.CryptBlocks(plaintext, ciphertext)
// 去除PKCS5填充
padding := int(plaintext[len(plaintext)-1])
if padding > aes.BlockSize || padding == 0 {
return "", fmt.Errorf("填充格式错误")
}
return string(plaintext[:len(plaintext)-padding]), nil
}Ruby端解密示例：
def aes_decrypt(encrypted_str, key, iv)
if key.bytes.length != 32
raise "密钥长度必须为32字节，当前长度为#{key.bytes.length}"
end
if iv.bytes.length != 16
raise "IV长度必须为16字节，当前长度为#{iv.bytes.length}"
end
cipher = OpenSSL::Cipher.new('AES-256-CBC')
cipher.decrypt
cipher.key = key
cipher.iv = iv
cipher.padding = 1
ciphertext = Base64.decode64(encrypted_str)
cipher.update(ciphertext) + cipher.final
end只要严格按照上述规范统一密钥长度、加密模式、填充方式和IV，Go和Ruby的AES加密就可以实现完全互操作，解决密钥长度配置带来的各种问题。