企微审批中MySQL字段TEXT类型被截断的排查与修复实践

在MySQL中，`TEXT`类型字段常用于存储较大的文本数据，但在一些应用场景中，当文本内容较大时，`TEXT`类型字段可能无法满足需求，导致数据截断或插入失败。为了避免这种问题，了解不同文本类型（如`TEXT`、`MEDIUMTEXT`、`LONGTEXT`）的适用范围，并根据实际需求选择合适的字段类型至关重要。本文将通过排查和修复过程，说明如何将字段类型从`TEXT`修改为`MEDIUMTEXT`，并介绍MySQL中的几种文本类型常识。

## 一、MySQL中不同文本类型的常识
如果文本数据在 64 KB 以内，使用 TEXT。
如果文本数据在 16 MB 以内，使用 MEDIUMTEXT。
如果文本数据可能超过 16 MB，使用 LONGTEXT。

MySQL提供了多种文本数据类型，主要分为三种：`TEXT`、`MEDIUMTEXT` 和 `LONGTEXT`。每种类型的大小限制不同，因此了解它们的适用场景和数据存储的最大限制非常重要。

### 1. `TEXT`类型

- 最大长度：65,535字节（约64KB）
- 用途：适用于存储较小的文本数据，文本大小在64KB以内时使用`TEXT`类型。
- 注意事项：如果文本数据较大，使用`TEXT`可能会导致存储失败或数据截断。

### 2. `MEDIUMTEXT`类型

- 最大长度：16,777,215字节（约16MB）
- 用途：适用于存储中等大小的文本数据，文本数据大小在64KB至16MB之间时使用`MEDIUMTEXT`类型。
- 注意事项：`MEDIUMTEXT`类型可以满足更大文本数据的存储需求，避免了`TEXT`类型的限制。

### 3. `LONGTEXT`类型

- 最大长度：4,294,967,295字节（约4GB）
- 用途：适用于存储非常大的文本数据，文本数据可能超过16MB时使用`LONGTEXT`类型。
- 注意事项：`LONGTEXT`适用于极大的文本数据，但会占用更多的存储空间和可能影响性能。

因此，根据应用场景选择合适的字段类型是非常关键的。如果字段类型为`TEXT`，但数据超过了64KB，就会出现截断问题。为了避免这种情况，通常会将字段类型从`TEXT`调整为`MEDIUMTEXT`或`LONGTEXT`。

## 二、TEXT字段被截断的排查过程

### 1. 确认字段类型

首先，我们需要确认表中实际的字段类型。执行以下查询语句来查看字段的类型：

```sql
DESCRIBE table_name;
```

这将显示表结构，包括每个字段的名称、数据类型及其它属性。如果发现字段类型是`TEXT`，并且预计该字段的文本数据将超过64KB，那么就需要考虑将其类型更改为`MEDIUMTEXT`或`LONGTEXT`。

### 2. 检查数据是否超过限制

如果存储的数据过大，超出了`TEXT`的64KB限制，会发生数据截断。可以尝试插入或更新一条包含大量文本的数据，看看是否会抛出错误或导致截断。

例如，尝试插入一条超过64KB的记录：

```sql
INSERT INTO table_name (column_name) VALUES ('<long_text>');
```

如果遇到数据丢失或报错信息（如：`Data too long for column`），说明文本数据超出了`TEXT`类型的存储限制。

### 3. 检查MySQL配置参数

在某些情况下，MySQL的配置参数`max_allowed_packet`会影响大数据的存储。如果该值设置得太小，可能会导致即使字段类型适合，也无法成功存储大文本数据。

检查当前的`max_allowed_packet`配置：

```sql
SHOW VARIABLES LIKE 'max_allowed_packet';
```

如果该值较小，可以通过修改`my.cnf`文件中的`max_allowed_packet`来增加最大数据包大小。例如：

```ini
[mysqld]
max_allowed_packet=64M
```

修改后需要重启MySQL服务。

### 4. 检查字符集

字符集配置不一致时，也可能导致存储大文本数据时出现问题。尤其是涉及多字节字符（如`utf8mb4`）时，需要确保字符集与应用程序一致。

可以检查数据库、表和字段的字符集：

```sql
SHOW CREATE TABLE table_name;
SHOW FULL COLUMNS FROM table_name;
```

如果字符集不一致，可以通过以下命令修改：

```sql
-- 修改字段字符集
ALTER TABLE table_name MODIFY column_name MEDIUMTEXT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
```

## 三、修复方案：将字段从TEXT改为MEDIUMTEXT

临时方案：测试环境，搞一条超限的数据，排查完整，正式环境查询表数据量小于100万，直接修改字段大小，再刷下数据，后期再考虑其他优化方案

如果确实是字段类型限制了数据存储，导致数据截断，可以考虑将字段类型从`TEXT`修改为`MEDIUMTEXT`。`MEDIUMTEXT`类型支持存储最大16MB的文本数据，可以满足大多数业务需求。

### 1. 修改字段类型

执行以下SQL命令，将字段类型从`TEXT`修改为`MEDIUMTEXT`：

```sql
ALTER TABLE table_name MODIFY column_name MEDIUMTEXT;
```

### 2. 检查修改后的效果

修改字段类型后，可以重新插入或更新大文本数据，确保不再发生数据截断问题。通过执行插入操作：

```sql
INSERT INTO table_name (column_name) VALUES ('<large_text>');
```

如果数据插入成功，说明问题已经解决。

### 3. 考虑更大的字段类型（如有必要）

如果预计数据会超过16MB，可以考虑将字段类型修改为`LONGTEXT`，支持最大4GB的文本数据。执行以下SQL命令：

```sql
ALTER TABLE table_name MODIFY column_name LONGTEXT;
```

不过，通常情况下，`MEDIUMTEXT`已经足够满足大部分需求，只有在数据极大时，才需要考虑使用`LONGTEXT`。

## 四、总结

通过本文的排查与修复过程，我们了解了`TEXT`、`MEDIUMTEXT`、`LONGTEXT`三种文本类型的不同适用场景，并针对`TEXT`类型字段被截断的问题提出了解决方案。如果字段的数据超过了`TEXT`的64KB限制，应该将其类型修改为`MEDIUMTEXT`或`LONGTEXT`，以避免数据截断。

具体修复步骤包括：

1. 确认字段类型，并检查数据是否超出`TEXT`类型的限制。
2. 检查MySQL配置，确保`max_allowed_packet`足够大，避免配置限制影响大数据存储。
3. 如果需要，将字段类型从`TEXT`修改为`MEDIUMTEXT`，或者根据需要使用`LONGTEXT`。
4. 确保字符集设置一致，避免字符集不一致导致数据存储问题。

这样，便可以确保文本数据不被截断，避免潜在的业务错误。