Python中使用Fernet遇ValueError：密钥需为32位URL安全Base64编码字节

错误原因分析 #

你遇到的ValueError: Fernet key must be 32 url-safe base64-encoded bytes错误，通常是因为读取到的密钥包含多余字符（比如换行、空格），或者密钥本身不符合格式。你提供的密钥b'ckUS_DFMD3P_t14204IndtLhHokAaQrFT48aY4TF2JU='本身是符合Fernet要求的，问题大概率出在从文件读取密钥的过程中。

解决方案 #

1. 检查密钥文件内容 #

打开etc/keys/key.key文件，确保文件里只有那串base64密钥字符串，没有多余的换行符、空格或者其他字符。很多编辑器保存文件时会自动在末尾加换行，这会导致读取的密钥包含额外的\n字节，从而触发格式错误。

2. 修改代码中的密钥读取逻辑 #

在读取密钥后，添加strip()方法去除多余的空白字符（包括换行、空格）：

def login():
    key_file_path = "etc/keys/key.key"

    # 读取密钥并去除多余空白字符
    with open(key_file_path, "rb") as key_file:
        key = key_file.read().strip()  # 新增strip()处理

    cipher_suite = Fernet(key)

    username = input("Enter your username: ")
    password = input("Enter your password: ")

    user_file_path = "etc/users/" + username + ".usr"

    if os.path.exists(user_file_path):
        with open(user_file_path, "rb") as file:
            enc = file.read()
            stored_password = cipher_suite.decrypt(enc).decode()

            if stored_password == password:
                print("Login successful!")
                user_terminal(username)
            else:
                print("Incorrect password. Please try again.")
    else:
        print("Error: User not found.")

3. 验证密钥有效性（可选） #

如果修改后仍有问题，可以先跳过文件读取，直接在代码中硬编码密钥测试，确认密钥本身是否正常：

# 替换读取文件的代码为以下内容
key = b'ckUS_DFMD3P_t14204IndtLhHokAaQrFT48aY4TF2JU='
cipher_suite = Fernet(key)

如果这样运行不报错，说明还是文件读取的问题，需要再次检查密钥文件的内容。

4. 确保密钥生成方式正确 #

生成密钥时必须使用Fernet官方的生成方法，避免手动修改密钥：

from cryptography.fernet import Fernet

# 生成符合要求的密钥
key = Fernet.generate_key()
# 写入文件时直接保存，不要额外添加换行
with open("etc/keys/key.key", "wb") as f:
    f.write(key)

额外注意事项 #

• 确保cryptography库版本为最新：执行pip install --upgrade cryptography
• 检查用户密码文件的加密过程是否和当前密钥匹配，避免用不同密钥加密/解密

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