求助：如何修复os.rename报错ValueError: embedded null character in dst

问题背景 #

执行文件重命名操作时触发上述错误，相关代码及报错信息如下：

原代码 #

import os
key = "12"
path = "C:\\Users\\User\\Desktop\\test"
os.chdir(path)
for a, b, files in os.walk(path):

    for file in files:
        Encoded = ""
        filesize = os.path.getsize(file)
        if filesize > 2000000 and file.split(".")[-1] == "pdf" or file.split(".")[-1] == "docx":
            LenFileName = len(file)
            for index in range(LenFileName):
                char = file[index]
                kelid = key[index % len(key)]
                Encoded += chr(ord(char) ^ ord(kelid))
            os.rename(file,Encoded)

报错信息 #

Traceback (most recent call last):
  File "E:\project\python\namecoder\namecoder.py", line 16, in <module>
    os.rename(file,Encoded)
ValueError: rename: embedded null character in dst

错误原因 #

1. 空字符生成：异或运算（^）可能生成ASCII值为0的字符（即\x00空字符），而所有主流文件系统都禁止文件名包含空字符，导致重命名失败。
2. 路径问题：os.walk遍历子目录时，file仅为文件名而非完整路径，当前工作目录是根路径path，会导致os.path.getsize(file)和os.rename(file, Encoded)找不到子目录中的文件，属于潜在BUG。

解决思路 #

1. 过滤/替换空字符 #

在生成加密文件名时，跳过或替换空字符，同时修正路径问题：

import os
key = "12"
path = "C:\\Users\\User\\Desktop\\test"

for a, b, files in os.walk(path):
    for file in files:
        # 拼接完整文件路径，解决子目录文件找不到的问题
        full_file_path = os.path.join(a, file)
        filesize = os.path.getsize(full_file_path)
        ext = file.split(".")[-1]
        if filesize > 2000000 and ext in ("pdf", "docx"):
            Encoded = ""
            LenFileName = len(file)
            for index in range(LenFileName):
                char = file[index]
                kelid = key[index % len(key)]
                encrypted_char = chr(ord(char) ^ ord(kelid))
                # 将空字符替换为下划线，避免文件系统报错
                Encoded += encrypted_char if encrypted_char != '\x00' else '_'
            # 拼接目标文件的完整路径
            full_dst_path = os.path.join(a, Encoded)
            os.rename(full_file_path, full_dst_path)

2. 改用无无效字符的编码方式 #

如果不需要异或的可逆加密特性，推荐使用base64编码（仅生成合法文件名字符），同时替换Windows系统不允许的+和/：

import os
import base64

key = "12"
path = "C:\\Users\\User\\Desktop\\test"

for a, b, files in os.walk(path):
    for file in files:
        full_file_path = os.path.join(a, file)
        filesize = os.path.getsize(full_file_path)
        ext = file.split(".")[-1]
        if filesize > 2000000 and ext in ("pdf", "docx"):
            # base64编码文件名，替换非法字符
            encoded_bytes = base64.b64encode(file.encode('utf-8'))
            Encoded = encoded_bytes.decode('utf-8').replace('+', '-').replace('/', '_')
            full_dst_path = os.path.join(a, Encoded)
            os.rename(full_file_path, full_dst_path)

额外建议 #

• 加密后建议保留原文件扩展名（如拼接.pdf/.docx），避免后续无法识别文件类型。
• 异或加密可逆，恢复文件名需用相同密钥再次异或；base64编码也可逆，无需密钥。

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