Django项目中文乱码报错全场景排查与修复指南

前言

在Django项目开发过程中，经常会遇到多种因中文处理不当引发的乱码报错。本文旨在对这些常见场景进行梳理，并提供相应的处理方案与总结。

常见的报错信息如UnicodeEncodeError: 'ascii' codec can't encode characters in position x-x: ordinal not in range(128)所示，通常由编码不匹配引起。

1. 代码中中文注释导致的报错

在Django项目的.py文件中添加中文注释时，常因编码定义缺失而报错，导致程序无法运行。解决该问题的最直接方法是在包含中文注释的.py文件顶部显式声明编码格式：

# -*-coding:utf-8 -*-

2. 运行过程中出现的中文乱码报错

首先，需确保所连接的数据库基础配置已设置为utf-8编码。

其次，确认Django项目生成的网页头部已正确设置编码为utf-8，具体做法是在网页HTML头部添加以下代码：

<meta charset="utf-8">

若上述设置后仍出现报错，通常是因为Django项目未明确指定编码方式，从而沿用了默认的非UTF-8设置。

因此，需要在项目中进行编码操作的关键位置，或者直接在settings.py配置文件中加入以下代码以强制指定编码：

import sys
reload(sys)
sys.setdefaultencoding('utf-8')

3. Debian系统中FileField字段因中文文件名上传报错

在某Django项目中发现，本地Windows测试环境下Django Admin的文件上传功能运行正常，但当项目部署至Debian环境时，包含中文文件名的文件在Admin后台无法上传，并报出中文乱码错误。该问题的根本原因在于Debian系统的编码设置问题：由于该系统未配置系统编码语言，保持默认设置，导致部署的项目无法正常处理中文。具体解决步骤如下：

（1）在终端中执行命令安装locales工具：

apt-get install locales

（2）重新配置字符编码选项：

dpkg-reconfigure locales

（3）在界面中使用空格键选中所有以zh_开头的字符编码，点击OK确认下一步，并选择中文UTF-8编码。

（4）在Debian系统中，还需在~/.bashrc文件末尾添加export LC_ALL=zh_CN.UTF-8，或者直接执行export LANG=zh_CN.UTF-8命令。

（5）最后，直接重启服务器（reboot）。重启后查看系统编码，确认UTF-8中文已生效。可通过locale命令直接查看系统编码设置。此时再运行Django项目，上传中文名文件即可正常无误。

附：Django邮件发送乱码解决方案

Python标准库中的email.message和email.header模块可用于处理邮件中的非ASCII字符。因此，需要对sendMail函数中的相关参数进行如下处理：

# coding=utf8 
from email.message import Message 
from email.header import Header 
 
mail_from=Header('友好互动', 'utf8') + "god_chen@sina.com"#a************** 
mail_to="god_chen@sina.com" 
mail_subj=Header("测试","utf8")#b*************** 
mail_content='\r\n<div>测试测试邮件</div>\r\n<a href="www.61pad.com">儿童派</a>' 
 
msg=Message() 
msg['Mime-Version']='1.0' 
msg['Content-type']='text/html' 
msg['From']=mail_from 
msg['To']=mail_to 
msg['Subject']=mail_subj 
msg.set_payload(mail_content,'utf8')#c************** 
 
server=connect(sm_host, sm_port, sm_user, sm_password) 
server.sendmail(mail_from, mail_to, msg.as_string()) 
server.close() 
 
def connect(host,port,user,password): 
  "connect server" 
  server=smtplib.SMTP() 
  server.connect(host, port) 
  server.login(user, password) 
  return server 

注：

a、使用Header对象处理发件人名称的乱码问题

b、使用Header对象处理邮件主题的乱码问题

c、使用Message对象处理邮件正文内容的乱码问题

上述处理中统一采用utf8编码。

总结

以上就是本文的全部内容，希望这些内容对大家的学习或工作具有一定的参考价值。如有疑问，欢迎留言交流，感谢支持。