如何消除Django+MySQL环境下的utf8别名UTF8MB3替换警告？

我之前也碰到过这个烦人的警告，完全懂你不想每次运行项目都看到它的心情！下面是几个实用的解决办法，你可以根据自己的需求选择：

方法一：切换到UTF8MB4字符集（推荐） #

这是最彻底的解决方案，不仅能消除警告，还能让数据库支持更完整的字符（比如emoji表情），毕竟MySQL官方也明确建议未来用UTF8MB4替代原有的UTF8（也就是UTF8MB3）。

修改你的Django项目根目录下的settings.py，在数据库配置中添加OPTIONS字段，明确指定字符集为utf8mb4：

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.mysql',
        'NAME': '你的数据库名称',
        'USER': '数据库用户名',
        'PASSWORD': '数据库密码',
        'HOST': 'localhost',
        'PORT': '3306',
        'OPTIONS': {
            'charset': 'utf8mb4',
            # 可选：添加这个命令确保SQL模式符合Django要求
            'init_command': "SET sql_mode='STRICT_TRANS_TABLES'",
        },
    }
}

保存配置后重启项目，这个警告应该就会消失了。如果你的数据库之前用的是UTF8MB3，建议后续把数据库和表的字符集也统一改成UTF8MB4，避免潜在的字符兼容问题。

方法二：仅屏蔽特定警告（临时方案） #

如果你暂时不想调整数据库字符集，只是单纯不想看到这个警告，可以通过Python的warnings模块过滤掉它。

在项目的settings.py开头或者根目录的__init__.py中添加以下代码：

import warnings

# 精准匹配警告内容，只屏蔽这个特定的MySQL警告
warnings.filterwarnings(
    "ignore",
    message=r".*'utf8' is currently an alias for the character set UTF8MB3.*"
)

这个方法只会隐藏你指定的警告，不会对数据库配置或其他功能产生影响，适合临时过渡使用。

方法三：升级mysqlclient版本 #

你当前使用的是mysqlclient 1.3.12，尝试升级到更高版本可能已经修复了这个警告的显示问题。在终端执行以下命令升级：

pip install --upgrade mysqlclient

注意：升级前最好备份项目环境，避免新版本和你的Django 2.0.4出现兼容性问题，升级后记得测试项目功能是否正常。

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