使用polars_encryption加密CSV失败，请求协助排查

问题重现 #

运行以下加密CSV到Parquet的函数：

import polars as pl
from polars_encryption import encrypt, decrypt

def crypt(csv_file: str, delim: str, password: str, output_file: str):
    """
    Save CSV to encrypted Parquet by encrypting all columns
    - csv_file: CSV file path (without .csv extension)
    - delim: CSV delimiter
    - password: Your encryption password
    - output_file: Output Parquet filename
    """
    # Read CSV
    df = pl.read_csv(f"{csv_file}.csv", separator=delim, encoding="UTF-8-SIG")
    
    # Pad/truncate password to 32 bytes (AES-256 key size)
    key = (password.encode() + b'\0'*32)[:32]
    nonce = b'minimal_nonce_'  # 12-byte fixed nonce
    
    # Encrypt all columns
    encrypted_df = df.with_columns([
        encrypt(pl.col(col_name), key=key, nonce=nonce).alias(col_name)
        for col_name in df.columns
    ])
    
    # Save encrypted DataFrame
    encrypted_df.write_parquet(output_file)

调用方式：

crypt(csv_file = file, delim = ';', password = 'testpass', output_file = 'new.pa')

触发错误：

ComputeError: the plugin panicked

The message is suppressed. Set POLARS_VERBOSE=1 to send the panic message to stderr.

解决步骤 #

1. 先获取详细panic日志 #

错误提示已给出方法，设置环境变量后重新运行脚本，就能看到具体panic原因：

# Linux/macOS终端
export POLARS_VERBOSE=1
python your_script.py

# Windows PowerShell
$env:POLARS_VERBOSE=1
python your_script.py

详细日志能精准定位问题，比如数据类型不兼容、nonce错误或密钥格式问题。

2. 针对常见触发原因的修复方案 #

（1）固定nonce的安全风险与修复

AES-GCM（多数加密插件的默认算法）要求同一个密钥不能重复使用相同的nonce，当前使用固定的b'minimal_nonce_'不仅可能触发panic，还会导致严重安全漏洞。替换为随机生成的12字节nonce，同时保存nonce（解密必须用到）：

import os

# 替换原nonce生成代码
nonce = os.urandom(12)  # 生成安全随机的12字节nonce
# 保存nonce到本地文件，解密时读取
with open("encryption_nonce.bin", "wb") as f:
    f.write(nonce)

（2）数据类型不兼容修复

polars_encryption的encrypt函数可能仅支持字符串类型列，若CSV包含数值、日期等类型，需先统一转为字符串：

# 在读取CSV后添加类型转换
df = pl.read_csv(f"{csv_file}.csv", separator=delim, encoding="UTF-8-SIG")
df = df.with_columns(pl.all().cast(pl.Utf8))  # 所有列转字符串

（3）密钥格式验证

确保密钥严格为32字节（AES-256要求），可以优化密钥处理代码使其更清晰：

# 替换原密钥处理代码
key = password.encode('utf-8').ljust(32, b'\0')[:32]

（4）版本兼容性检查

polars与polars_encryption版本不匹配是常见panic原因，确认两者版本兼容，比如安装指定版本：

pip install polars==0.20.2 polars_encryption==0.1.0
# 版本号请以polars_encryption官方文档为准

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