Cpanel主机环境下MySQL连接报错：字符集'255'不支持求助

这个错误的核心是MySQL连接驱动将字符集解析成了无效的数字255，而非合法的字符集名称，以下是几种可行的解决方法：

• 明确指定连接的字符集参数
  在Django项目的settings.py中，给数据库配置添加OPTIONS字段，强制指定字符集和排序规则：

DATABASES = {
    'default': {
        'ENGINE': 'mysql.connector.django',
        'NAME': '你的数据库名称',
        'USER': '你的数据库用户名',
        'PASSWORD': '你的数据库密码',
        'HOST': 'localhost',  # CPanel环境下通常使用localhost
        'PORT': '3306',
        'OPTIONS': {
            'charset': 'utf8mb4',
            'collation': 'utf8mb4_unicode_ci',
        },
    }
}

• 替换数据库驱动为mysqlclient
  mysql-connector-python在部分环境下存在字符集解析问题，换成更稳定的mysqlclient试试：

1. 安装mysqlclient：

pip install mysqlclient

2. 修改settings.py中的数据库引擎：

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.mysql',  # 替换为官方MySQL引擎
        'NAME': '你的数据库名称',
        'USER': '你的数据库用户名',
        'PASSWORD': '你的数据库密码',
        'HOST': 'localhost',
        'PORT': '3306',
        'OPTIONS': {
            'charset': 'utf8mb4',
            'init_command': "SET sql_mode='STRICT_TRANS_TABLES'",
        },
    }
}

• 检查CPanel数据库的字符集设置
  登录CPanel后台，进入MySQL数据库管理界面，查看目标数据库的默认字符集是否为utf8mb4或utf8，如果不是，可修改数据库的字符集（操作前建议备份数据）。

• 清理连接缓存
  重启Django服务，或重新安装项目依赖，清除可能存在的旧连接缓存。

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