Python处理FTP服务器非UTF-8编码文件方法详解
在使用Python连接FTP服务器下载文件时，若服务器文件名包含非UTF-8编码字符（例如GBK），直接用UTF-8解码会报错。本文提供多种解决方案，助您轻松应对此类编码问题。
例如，以下代码尝试获取FTP服务器指定目录的文件列表，可能因编码问题报错：
import ftplib
ftp = ftplib.FTP()
ftp.encoding = 'utf-8'
ftp.connect('10.21.x.x', 10021)
ftp.login('ftpuser', 'ftpuser')
wdir = ''
file_list = []
ftp.retrlines(f"list {wdir}", file_list.append)
print(file_list)
解决方法如下：
-
探测FTP服务器默认编码: 虽然
ftplib本身不支持直接获取服务器编码，但您可以尝试扩展该库或使用其他库实现此功能。立即学习“Python免费学习笔记（深入）”；
-
多编码尝试: 若已知服务器可能使用的编码（如UTF-8和GBK），可以依次尝试解码文件名，直到成功。
-
第三方库: 一些第三方库（如
paramiko，支持SSH和SFTP）提供更完善的编码支持和错误处理。 -
升级FTP服务器: 将FTP服务器升级至支持UTF-8编码是最佳长期方案，确保文件名编码统一。
-
避免特殊字符: 限制上传文件名仅使用ASCII字符可避免编码问题，这需要在客户端进行文件名清理或转换。
-
自定义异常处理: 在解码文件名时，捕获
UnicodeDecodeError异常，尝试其他编码解码，或忽略/替换无法解码的字符。
以下示例演示如何使用ftplib和多种编码解码文件名：
import ftplib
def decode_filename(filename, encodings=['utf-8', 'gbk']):
for enc in encodings:
try:
return filename.decode(enc)
except UnicodeDecodeError:
pass
return filename # 所有编码尝试失败，返回原始字节
ftp = ftplib.FTP('ftp.example.com')
ftp.login('user', 'passwd')
dir_list = ftp.nlst('/path/to/directory')
for raw_filename in dir_list:
filename = decode_filename(raw_filename)
print(filename)
# ... 下载文件 ...
ftp.quit()
通过以上方法，您可以有效处理FTP服务器上的非UTF-8编码文件，避免编码错误。
