> ## Documentation Index
> Fetch the complete documentation index at: https://docs.squarecloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# 数据库内存、连接数与慢查询

> 解决 Square Cloud 上的数据库问题：RAM 持续增长、因内存不足而停止、连接过多、慢查询、磁盘已满，以及强制停止后启动缓慢。

大多数数据库问题表现为看似泄漏的内存、耗尽的连接或变慢的查询。请从下面的症状入手；各引擎的细节请参阅 [PostgreSQL](https://docs.squarecloud.app/zh/services/databases/postgresql.md)、[MySQL](https://docs.squarecloud.app/zh/services/databases/mysql.md)、[MongoDB](https://docs.squarecloud.app/zh/services/databases/mongodb.md) 和 [Redis](https://docs.squarecloud.app/zh/services/databases/redis.md) 页面。

## RAM 持续增长

**含义：** 数据库启动后 RAM 图表不断攀升，然后保持在高位，即使流量下降也是如此。

**发生原因：** 控制面板中显示的 RAM 是实例的全部内存，其中包括引擎保持热态的操作系统文件缓存。每种引擎也会有意占用内存：

* **PostgreSQL：** `shared_buffers`（RAM 的 25%）加上文件缓存。
* **MongoDB：** WiredTiger 缓存，以及一个会保留已释放内存以便复用的分配器。
* **MySQL：** InnoDB buffer pool（除非你调高过，否则为 128 MB）加上文件缓存。
* **Redis：** 数据本身，最多占 RAM 的 90%。

先上升再趋于平稳是正常现象，不是内存泄漏。

**什么时候才是问题：** 如果数据库内存耗尽，它会被停止，并且在你再次启动之前一直保持停止状态（因内存不足而停止后不会自动重启）。此时：

1. 从控制面板启动它。
2. 找出增长的来源：对过多数据执行的查询或聚合、过多的连接（每个连接都要占用内存），或者在 Redis 上没有过期时间的键。
3. 减少这些占用，或为数据库分配更多 RAM。

## 连接过多

**含义：** 新连接被拒绝：

| 引擎 | 信息 |
| :- | :- |
| PostgreSQL | `remaining connection slots are reserved for roles with the SUPERUSER attribute` / `sorry, too many clients already` |
| MySQL | `Too many connections` |
| MongoDB | 连接立即关闭 |
| Redis | `max number of clients reached` |

**发生原因：** 无论大小，每个数据库最多接受 256 个同时连接（PostgreSQL 上可供你的客户端使用的为 253 个）。常见原因包括：每个请求都新建客户端或连接、按模块而不是按进程创建连接池、多个应用或分片各自使用一个大连接池，或者在 MongoDB 上创建了很多 `MongoClient` 实例（每个实例都会在其连接池之外再增加 2 个监控连接）。

**如何修复：**

1. 在启动时为**每个进程创建一个连接池或客户端**，并在各处重复使用（`pg.Pool`、`mysql2.createPool`、一个 `MongoClient`、一个 Redis 客户端）。
2. 调整连接池大小，使所有进程加起来仍低于上限并留有余量：4 个进程各使用大小为 20 的连接池，就会占用 80 个连接。
3. 打开数据库的 **Insights** 选项卡，查看是哪些客户端地址占用着连接（每个 IP 地址的第三段会被隐藏）。

## 慢查询

**含义：** 对你的应用的请求变慢，数据库的 CPU 一直很高。

**如何找到它们：** **Insights** 选项卡会列出慢查询，每 60 秒刷新一次：

* **PostgreSQL 和 MySQL：** 语句及其平均耗时，只要有任意一次运行达到 100 ms 或以上就会列出。
* **MongoDB：** 来自 profiler 的、耗时 100 ms 或以上的单个操作。
* **Redis：** `SLOWLOG`，即耗时 10 ms 或以上的命令。

**如何修复：** 对慢查询运行引擎自带的 explain，并添加它需要的索引（PostgreSQL 上用 `EXPLAIN ANALYZE`，MySQL 上用 `EXPLAIN`，MongoDB 上用 `explain("executionStats")`）。在 Redis 上，把遍历整个键空间或超大键的命令（`KEYS`、对巨大哈希执行 `HGETALL`）替换为 `SCAN`、`HSCAN` 和 `SSCAN`。读取大量数据的查询也需要 RAM：RAM 越多，能保留在缓存中的数据就越多。

## 数据库自行停止了

| 原因 | 你会看到 | 接下来会发生什么 |
| :- | :- | :- |
| 内存不足 | 数据库已停止；RAM 图表达到了上限。 | 在你启动它之前一直保持停止。参见 [RAM 持续增长](#ram-持续增长)。 |
| 因错误而崩溃 | 数据库意外停止。 | 它会自动重启，每小时最多一次，并且仅当它此前已运行至少 60 秒时才会重启。 |
| 存储已满（MongoDB） | MongoDB 停止写入并关闭。 | 保持停止状态。参见[磁盘已满](#磁盘已满)。 |

## 磁盘已满

每个数据库拥有固定的 **10 GB 存储**。数据、索引和引擎自身的文件共用这部分空间：PostgreSQL 的预写日志（256 到 512 MB）、MongoDB 的诊断数据（最多 200 MB）、开启慢查询日志时 MySQL 的 `mysql.slow_log` 表，以及 Redis 在数据文件旁边保存数据时所需的空间。

| 引擎 | 写满时会发生什么 |
| :- | :- |
| PostgreSQL | 写入失败（`could not extend file ... No space left on device`）。 |
| MySQL | 写入失败（`The table '...' is full`）。 |
| MongoDB | 服务器停止，且不会自行恢复。 |
| Redis | 保存失败，在某次保存成功之前写入会返回 `MISCONF`。 |

**如何修复：**

1. 删除或归档不需要的数据，并删除未使用的索引。图片和上传内容等文件应放在 [Blob Storage](https://docs.squarecloud.app/zh/services/blob.md) 中，而不是数据库里。
2. 回收空间：在 PostgreSQL 上，普通的 `VACUUM` 会让空间在表内可被重新使用，而 `VACUUM FULL` 会把空间归还给磁盘，但运行期间需要与表大小相当的空闲空间。在 MySQL 上，`OPTIMIZE TABLE` 会重建表。在 MongoDB 上，对集合执行 `compact`。
3. 在 MongoDB 上，先从控制面板启动数据库，然后立即释放空间。

> [!WARNING]
>
> 接近 10 GB 的数据库也可能无法创建 snapshot：一次导出的上限约为 10 GB，而 PostgreSQL 和 MySQL 的导出是未压缩的 SQL 文本。请留出余量。

## 停止后启动缓慢

**含义：** 刚启动后，PostgreSQL 返回 `the database system is not yet accepting connections`，或者 MySQL 需要很长时间才能接受连接。

**发生原因：** 停止数据库时，它有 5 秒时间完成正常关闭；繁忙的数据库可能需要更久，于是会被强制停止。下次启动时，它会执行崩溃恢复（PostgreSQL 重放其预写日志，MySQL 的 InnoDB 恢复其表），数据库越大耗时越长。

**如何修复：** 等待恢复完成；等待不会造成任何数据丢失。请在写入负载较低时停止数据库。

## 相关指南

* [数据库概览](https://docs.squarecloud.app/zh/services/databases.md)：限制、snapshot、Insights 以及每个数据库包含的内容。
* [数据库连接错误](https://docs.squarecloud.app/zh/platform/troubleshooting/database-connection-errors.md)：SSL/TLS、身份验证和网络错误。

## 联系我们

如果你仍然遇到**技术问题**，我们的**专业支持团队**可以为你提供帮助。[**联系我们**](https://squarecloud.app/zh/support)，我们很乐意协助你解决任何问题，支持质量正是开发者给予 Square Cloud [**4.9/5 评分（共 402 条评价）**](https://www.trustpilot.com/review/squarecloud.app)（Google 与 Trustpilot）的重要原因之一。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.