如何解决使用 django-ftpserver 上传中文文件名乱码的问题

Django-ftpserver 是一个基于 django 的 FTP 服务器应用，它可以让我们轻松地在 django 项目中集成 FTP 服务。它使用 pyftpdlib 库来实现 FTP 协议的功能。

最近，我在使用 django-ftpserver 提供 FTP 服务时，遇到了一个问题：当我上传文件时，如果文件名包含中文字符，那么在服务器端就会出现乱码，导致无法正常访问文件。例如，我上传了一个名为“中文.txt”的文件，但是在服务器端看到的却是“涓枃.txt”。

经过一番排查，我发现这个问题是由于 pyftpdlib 库的编码设置导致的。pyftpdlib 库默认使用 ASCII 编码来处理文件名，而 ASCII 编码并不能支持中文字符。因此，当我上传包含中文字符的文件名时，就会出现乱码。

那么，如何解决这个问题呢？经过一些尝试，我找到了一个简单而有效的方法：重写 FTPHandler 类，并设置其 encoding 属性为 ‘gbk’，并改写decode方法。

FTPHandler 类是 pyftpdlib 库提供的一个基类，它定义了 FTP 协议的各种命令和响应的处理方法。我们可以通过继承这个类，并覆盖其中的一些方法来自定义我们的 FTP 处理器。

在这里，我们只需要继承 FTPHandler 类，并设置其 encoding 属性为 ‘gbk’并改写decode方法，就可以让 FTP 处理器使用 gbk 编码来处理文件名。gbk 编码是一种常用的中文编码方式，它可以支持中文字符。

重写 FTPHandler 类的代码如下：

from pyftpdlib.handlers import FTPHandler

class CustomFTPHandler(FTPHandler):
    """
    解决 pyftpdlib 中文编码问题
    """
    encoding = "gbk"

    def decode(self, bytes):
        return bytes.decode(self.encoding, self.unicode_errors)

然后，在 django 的 settings.py 文件中，加入以下一行代码：

FTPSERVER_HANDLER = "ftpdemo.handlers.CustomFTPHandler"

这样就可以告诉 django-ftpserver 使用我们自定义的 CustomFTPHandler 类来处理 FTP 请求。

重启服务后，问题就解决了。我再次上传“中文.txt”文件，就可以在服务器端看到正确的文件名，并且可以正常访问文件。

如果你觉得我的文章还不错，确实解决了您的一些问题的话，麻烦点个赞、收藏、加粉丝，如果有什么问题可以在评论区交流，我将及时答复或者做出修正，谢谢！