返回文档中心

数据库连接

您可以使用平台自动创建的默认 MySQL 数据库，也可以接入自己的数据库，例如阿里云 RDS、腾讯云数据库或自建 MySQL。

1

选择数据库来源

平台提供默认数据库是为了让新项目能快速跑通，但不是强制项。如果您已经有阿里云 RDS、腾讯云数据库、云服务器自建 MySQL 等数据库，可以直接使用自己的连接信息。

使用平台默认数据库
适合快速验证、演示项目和小型服务
使用自有数据库
适合已有生产数据、团队统一数据库或云厂商 RDS

使用自有数据库时，平台不会创建、修改或删除您的数据库，只负责把您填写的连接参数注入到应用服务环境变量中。

2

确认连接信息

如果使用平台默认数据库，进入控制台的「我的数据库」页面，等待数据库状态变为「运行中」。默认数据库名称按 用户代码_用户名 生成，数据库密码与注册登录密码一致。

用户名会先转换为数据库安全格式：只保留小写字母、数字和下划线；中文、空格和特殊符号会被处理掉。如果用户名无法转换，会使用 user 作为名称片段，例如 ab_user。

主机地址
数据库卡片中的主机字段
数据库名称
数据库卡片标题或详情页名称
用户名
数据库卡片中的用户名字段
密码
注册登录密码
数据库连接信息页面

如果使用阿里云 RDS 等自有数据库，请在云厂商控制台复制内网或公网连接地址、端口、数据库名、用户名和密码，并确认安全组或白名单允许平台服务访问。

3

使用客户端连接

您可以使用 DBeaver、HeidiSQL、Navicat 或命令行连接数据库。平台默认数据库执行后输入注册登录密码；自有数据库则输入您在云厂商或自建 MySQL 中设置的密码。

mysql -h <主机地址> -u <数据库用户名> -p <数据库名称>

如果使用 DBeaver，创建 MySQL 连接后填入主机、数据库名、用户名和密码。部分 MySQL 版本需要在驱动属性中启用 allowPublicKeyRetrieval=true。

DBeaver 驱动属性设置数据库连接成功
4

接入应用配置

推荐把数据库参数放到应用服务的环境变量里，不要写死在代码中。下面的变量既适用于平台默认数据库，也适用于阿里云 RDS 等自有数据库：

DB_HOST=<主机地址>
DB_PORT=3306
DB_NAME=<数据库名称>
DB_USER=<数据库用户名>
DB_PASSWORD=<数据库密码>

Spring Boot 项目可以使用以下环境变量名称：

SPRING_DATASOURCE_URL=jdbc:mysql://<主机地址>:<端口>/<数据库名称>?useSSL=false&allowPublicKeyRetrieval=true&serverTimezone=Asia/Shanghai
SPRING_DATASOURCE_USERNAME=<数据库用户名>
SPRING_DATASOURCE_PASSWORD=<数据库密码>

平台默认数据库的初始密码与注册登录密码一致；自有数据库的密码以您在数据库服务中设置的密码为准。更新平台登录密码不会自动修改数据库密码。

5

排查连接问题

  • 连接超时：确认主机地址是否正确，数据库状态是否为运行中。
  • 认证失败：确认用户名是否复制完整，密码是否为注册时的登录密码。
  • RDS 无法访问：检查安全组、白名单、公网访问开关，以及数据库账号是否允许远程连接。
  • Public Key 错误：在客户端或 JDBC URL 中添加 allowPublicKeyRetrieval=true。
  • 应用启动失败：检查环境变量是否已保存，并重新部署应用服务。