Django连接AWS RDS MSSQL：Nvarchar(max)自动截断问题求助

我之前在项目里也碰到过一模一样的情况——用TextField对应MSSQL的nvarchar(max)，结果超过4000字符的文本还是被莫名截断了。结合Django和AWS RDS的特性，给你梳理几个关键的排查和修复步骤：

1. 修正Django数据库连接配置 #

首先要确保你用的是适配MSSQL的Django后端（推荐django-pyodbc-azure，这是目前最稳定的MSSQL适配引擎），然后重点检查连接选项里的长文本参数：

在项目的settings.py中，给DATABASES添加关键的OPTIONS配置：

DATABASES = {
    'default': {
        'ENGINE': 'sql_server.pyodbc',
        'NAME': '你的数据库名',
        'USER': '你的RDS用户名',
        'PASSWORD': '你的RDS密码',
        'HOST': '你的RDS端点地址.amazonaws.com',
        'PORT': '1433',
        'OPTIONS': {
            'driver': 'ODBC Driver 17 for SQL Server',
            # 核心参数：让pyodbc正确识别nvarchar(max)的长度
            'MAX_VARCHAR_SIZE': 0,
            'unicode_results': True,
        },
    }
}

这里的MAX_VARCHAR_SIZE: 0是关键——pyodbc默认会把nvarchar(max)当成4000字符的字段处理，设置为0后才会让它识别为真正的无上限长度。

2. 验证数据库表字段的实际类型 #

有时候即使Django模型定义了TextField，也可能因为迁移历史或配置问题，实际RDS里的字段不是nvarchar(max)。你可以通过RDS的查询编辑器或本地SQL工具连接数据库，执行以下SQL检查：

SELECT DATA_TYPE, CHARACTER_MAXIMUM_LENGTH 
FROM INFORMATION_SCHEMA.COLUMNS 
WHERE TABLE_NAME = '你的表名' AND COLUMN_NAME = '你的长文本字段名';

如果返回的CHARACTER_MAXIMUM_LENGTH是4000而不是NULL（MSSQL中nvarchar(max)的长度显示为NULL），说明字段类型不对。这时候可以通过修改模型（比如临时加个注释再改回去）触发新的迁移，执行python manage.py makemigrations和python manage.py migrate来修正字段类型。

3. 排除RDS实例的隐性限制 #

AWS RDS MSSQL本身对nvarchar(max)是支持的（最大可存2GB数据），但需要注意两个点：

• 确保你的RDS实例使用的SQL Server版本不低于2012（旧版本对max字段的兼容性稍差，不过RDS默认配置一般都符合要求）
• 确认RDS实例的存储空间足够，虽然这不是截断的直接原因，但如果空间不足可能会引发其他写入问题

4. 排查代码中的隐性截断操作 #

有时候问题出在业务代码里，而非数据库配置：

• 检查表单或序列化器是否给该字段设置了max_length限制
• 查看保存前的信号、钩子函数或业务逻辑，有没有对文本做了切片、截断处理

可以在保存数据前打印文本长度，确认传入数据库前内容是完整的。

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