# 

迁移到云数据库之后，有一类工单变多了：用户反馈地址、备注、商品名「只存了一半」。

排查发现不是迁移导致的数据损失，而是应用层有一段按字节截断的代码，在新字符集下与实际存储规则对不上。

## 现象长什么样？

一条带省市区的详细地址，存进去之后查出来只有前六个字。

团队当时的判断很一致：一个汉字占三个字节，字段长度定义成二十，二十除以三，所以只能存六个字。

按这个逻辑把长度调到六十，看起来能存二十个汉字了。新问题马上来了：英文地址带门牌号和单元号，超过二十个字符就被截。

改来改去，始终对不上。

## 那个长度到底是什么单位？

数据库手册在字符类型那一节开头写得很清楚：

> The CHAR and VARCHAR types are declared with a length that indicates the maximum number of characters you want to store. For example, CHAR(30) can hold up to 30 characters.

「声明时的长度表示你希望存储的**最大字符数**。例如长度为三十的字段最多能存三十个字符。」

字符，不是字节。所以长度二十的字段能存二十个汉字，也能存二十个英文字母。

那为什么还会「只存一半」？因为真正的原因不在数据库，在写库之前的一段代码——那段代码是历史遗留，按字节判断长度，超过二十字节就截断。字段长度后来被改成字符数，两边口径对不上。

| 现象 | 可能原因 | 怎么确认 |
| --- | --- | --- |
| 中文只存前半截 | 应用层按字节截断 | 看写库前的代码 |
| 报数据过长 | 严格模式下超字符数 | 统计实际字符数 |
| 报整行过大 | 所有列加起来超字节上限 | 各列字节数相加 |
| 建索引失败 | 索引前缀超限 | 看报错里的长度 |

## 字符数和字节数在哪一步分叉？

在存储与行大小这一层。手册接着写：

> The effective maximum length of a VARCHAR is subject to the maximum row size (65,535 bytes, which is shared among all columns) and the character set used.

「有效最大长度受最大行大小（六万五千五百三十五字节，由所有列共享）和所用字符集的限制。」

两个约束叠在一起：声明上限是字符数，实际可用受整行字节数限制。

| 约束 | 数值 | 谁在限制 |
| --- | --- | --- |
| 声明长度上限 | 六万五千五百三十五字符 | 语法层 |
| 行大小上限 | 六万五千五百三十五字节，全列共享 | 存储层 |
| 单列索引前缀上限 | 取决于行格式与字符集 | 索引层 |

在四字节编码下，一个字符最多占四字节。所以声明一万六千多字符就把整行额度用完了，其他列一个字节都放不下。

建表时报整行过大，撞的是第二行。它说的不是字段太长，是整行超了。

## 云上迁移为什么容易暴露这类问题？

三个原因。

第一，字符集升级。老实例常用三字节编码，新实例默认四字节编码，同样的字段能存的字节数变多，但按字节截断的代码没改。

第二，SQL 模式差异。老实例可能是非严格模式，超长值被静默截断并给个警告；新实例默认严格模式，直接报错。行为从「悄悄截断」变成「写入失败」，问题才被暴露。

第三，参数模板不同。云数据库提供默认参数模板，不同版本、不同规格的模板里，字符集与模式的默认值可能不一样。

所以迁移时的第一件事，是比对两边的字符集与模式，而不是先看数据量。

| 比对项 | 老实例 | 新实例 | 影响 |
| --- | --- | --- | --- |
| 默认字符集 | 三字节编码 | 四字节编码 | 存储占用变化 |
| SQL 模式 | 可能非严格 | 通常严格 | 超长从截断变报错 |
| 排序规则 | 旧版规则 | 新版规则 | 比较行为变化 |
| 默认存储引擎 | 视版本 | 视版本 | 行格式限制不同 |

## 为什么尾随空格会让唯一索引冲突？

这是变长与定长类型行为差异明显的地方，也是迁移之后另一类工单的来源：用户名末尾多敲一个空格，系统提示「已存在」。

手册写得很细：变长类型的值存储时不补齐，存储和检索时都保留尾随空格；定长类型相反，存储时用空格补齐到指定长度，检索时把尾随空格去掉。

真正决定比较行为的是排序规则的填充属性：

> MySQL collations have a pad attribute of PAD SPACE, other than Unicode collations based on UCA 9.0.0 and higher, which have a pad attribute of NO PAD.

「MySQL 的排序规则填充属性为「填充空格」，基于较新版本统一排序规则的那些除外，它们的属性是「不填充」。」

| 填充属性 | 比较时如何对待尾随空格 | 结果 |
| --- | --- | --- |
| 填充空格 | 忽略 | 两个值视为相同 |
| 不填充 | 当普通字符 | 两个值不同 |

手册把后果写得很直接：如果列上有要求值不重复的索引，插入只差尾随空格个数的值，会导致重复键错误。

还有一句提醒很重要：SQL 模式对比较行为没有影响，别指望改模式解决。

## 长度到底该怎么定？

三步。

第一步按业务上限估字符数，不按字节。手机号十一位，身份证十八位，姓名给五十（覆盖少数民族与外国姓名）。

第二步算字节占用，看整行额度。用四字节编码就按每字符四字节估上界，虽然大部分中文只占三个。

第三步加两成到五成的余量，别直接定二百五十五。

| 字段 | 建议长度 | 说明 |
| --- | --- | --- |
| 手机号 | 定长十一位 | 定长数字串 |
| 身份证 | 定长十八位 | 定长 |
| 姓名 | 变长五十 | 覆盖长姓名 |
| 详细地址 | 变长二百五十五 | 接近索引前缀上限，慎建索引 |
| 备注 | 变长一千或长文本 | 超过一千考虑长文本类型 |

第四行那个「慎建索引」有来由：二百五十五字符乘四字节等于一千零二十字节，超过部分行格式的单列索引前缀限制时，索引会被截断或建不上。

## 改完之后要注意什么？

三件事。

一是历史数据。已经截断的内容无法恢复，只能靠业务方重新补录或从上游系统对齐。

二是应用层。所有按字节判断长度的地方都要改，包括参数校验、表单限制、导出文件。

三是监控。给「疑似截断」加一条告警：写入长度等于字段上限的记录数突然上升，通常意味着上游有异常。

这套字段长度对照表我整理进了项目的建表规范，最早散在几次「数据被截断」的排查记录里，用 AI墨衍 把其中的判断依据归拢成按「字段、建议长度、依据」三列排的表，几个项目共用。

## 小结

三句话：长度指的是字符，行上限按字节共享，尾随空格参与比较。

云上迁移时先比对字符集与模式，比事后从工单里捞原因便宜得多。


排查发现不是迁移导致的数据损失，而是应用层有一段按字节截断的代码，在新字符集下与实际存储规则对不上。

云数据库里地址字段只存了一半，问题在长度的单位

人工智能

迁移云数据库后常见数据截断问题根因在应用层按字节截断与字符集变化不匹配，而非数据丢失。字段长度定义以字符为单位，实际受整行字节上限与排序规则影响。建议按业务字符上限定义字段，预留余量，排查历史遗留代码，关注字符集与SQL模式差异，避免尾随空格导致唯一索引冲突。

云数据库

数据库

MySQL

腾讯云双十一大促

postgres

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

云数据库里地址字段只存了一半，问题在长度的单位-腾讯云开发者社区-腾讯云

云数据库里地址字段只存了一半，问题在长度的单位

云数据库里地址字段只存了一半，问题在长度的单位

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐