企业官网建设流程全解析

如何快速修复 Nacos "No DataSource set"：MySQL 数据源启动失败 5 步排查指南

【免费下载链接】nacosan easy-to-use dynamic service discovery, configuration and service management platform for building AI cloud native applications.项目地址: https://gitcode.com/GitHub_Trending/na/nacos

在 Nacos 中配置了 MySQL 外部数据源后，启动时抛出No DataSource set异常导致服务起不来？这篇文章带你按嫌疑度从高到低走完 5 个排查点，每个点都讲清「怎么判断 → 怎么修 → 怎么验证」，修完 Nacos 就能正常连上数据库启动。

报错长什么样

典型场景是：你把 Nacos 从默认的内嵌数据库切换成 MySQL，改完配置重启，服务没起来，日志里能看到 Spring 在初始化 JDBC 组件时直接报错，核心堆栈往往不长，但下面那句No DataSource set很扎眼：

Caused by: java.lang.IllegalStateException: No DataSource set at org.springframework.jdbc.core.JdbcTemplate.executeInternal(JdbcTemplate.java:337) at org.springframework.jdbc.core.JdbcTemplate.query(JdbcTemplate.java:467) Caused by: java.sql.SQLException: Access denied for user 'nacos'@'10.0.0.5' at com.mysql.cj.jdbc.NonRegisteringDriver.connect(...)

看到这个先别慌。No DataSource set本身只是「拿不到可用连接」的兜底报错，真正的原因基本落在这几类里：连接参数写错、JDBC 驱动缺失、库表结构没初始化、网络不通、账号权限不足。按下面的顺序逐个排除，多数情况第一步就能命中。

按嫌疑度逐个排查

1. 先核对数据源连接参数（最常见）

怎么判断是它：翻启动日志里Caused by之后的第一条Caused by，如果写着Access denied（账号密码错）或Unknown database 'nacos'（库名不存在），就是参数问题。

怎么修：打开 distribution/conf/application.properties，确认这几项都写对、且没被注释掉：

spring.sql.init.platform=mysql nacos.plugin.datasource.db.num=1 nacos.plugin.datasource.db.url.0=jdbc:mysql://127.0.0.1:3306/nacos?characterEncoding=utf8&connectTimeout=1000&socketTimeout=3000&autoReconnect=true&useUnicode=true&useSSL=false&serverTimezone=UTC nacos.plugin.datasource.db.user=nacos nacos.plugin.datasource.db.password=nacos

注意三个高频坑：① 旧版db.*与新nacos.plugin.datasource.db.*两种写法混用时以新写法为准，别两处各写一套；② URL 里的库名必须已经CREATE DATABASE过；③ 密码里有&、#这类特殊字符时先换掉或转义。

修完怎么验：改完重启，日志里不再出现Access denied/Unknown database即通过。

2. 确认 lib 目录里有 MySQL 驱动

怎么判断是它：日志报No suitable driver或ClassNotFoundException: com.mysql.cj.jdbc.Driver，且连接参数你已确认无误。

怎么修：MySQL 连接靠 JDBC 驱动 jar 包（简单说就是「讲 MySQL 协议」的翻译官，Nacos 不带这个 jar 就连不上 MySQL）。从 MySQL Connector/J 官方渠道下载与你 MySQL 版本匹配的驱动（MySQL 5.7 建议 5.1.x 或 8.0.x 均可，MySQL 8 建议 8.0.x），放进 Nacos 安装目录的lib/下再重启。

修完怎么验：启动日志里能看到成功建立连接的 DEBUG 记录、或至少ClassNotFoundException消失即通过。

3. 检查库表结构是否已初始化

怎么判断是它：连接能建立、账号也有权限，但日志报Table 'nacos.config_info' doesn't exist这类「表不存在」错误。

怎么修：执行 Nacos 自带的建表脚本（仓库内对应文件见 mysql-schema.sql，发行包里一般在conf/目录）：

mysql -unacos -p nacos < /path/to/nacos/conf/mysql-schema.sql

脚本会一次性建好config_info、users、cluster_config等 Nacos 运行所需的全部表，重复执行前记得确认脚本内是CREATE TABLE还是带DROP的版本，别在生产库上误删数据。

修完怎么验：连上库执行SHOW TABLES;，能看到config_info、users等 Nacos 核心表即通过。

4. 验证 MySQL 网络与端口可达

怎么判断是它：日志报Communications link failure或connect timed out，且参数、驱动都没问题。

怎么修：先从 Nacos 所在机器测端口连通性（端口 3306 是 MySQL 默认监听端口）：

telnet <mysql-host> 3306

通则输入Ctrl+]关闭；不通就分两层查：MySQL 服务是否启动（systemctl status mysqld）、防火墙或安全组是否放行 3306。另外看一眼 MySQL 的bind-address，若绑定的是127.0.0.1就只允许本机连，跨机部署要改成实际 IP 或0.0.0.0并重启 MySQL。

修完怎么验：telnet能建立连接、Caused by里不再出现timed out即通过。

5. 核查数据库账号权限（最容易被忽略）

怎么判断是它：连得上、库也在，但报Access denied或查询时提示privilege相关错误，说明账号密码对了但权限范围不对。

怎么修：注意权限是「按 host 授予」的——'nacos'@'localhost'的权限管不到从其他机器发起的连接。登录 MySQL 用管理员账号，把权限授到 Nacos 实际连接的来源：

GRANT ALL PRIVILEGES ON nacos.* TO 'nacos'@'%' IDENTIFIED BY 'nacos'; FLUSH PRIVILEGES;

生产环境建议把'%'换成具体网段，别全放开。

修完怎么验：用 Nacos 配置里的同一个账号、从 Nacos 机器连库执行USE nacos; SELECT 1;，无报错即通过。

修好之后

• 驱动版本和 MySQL 版本要配套：MySQL 8 配 Connector/J 8.0.x，避免再出现Public Key Retrieval is not allowed这类版本不匹配的新报错。
• 连接参数集中管理：URL、账号、库名这类信息只在application.properties一处维护，升级 Nacos 时先备份该文件，防止升级覆盖配置后数据源「变回」内嵌数据库。
• 定期备份核心表：config_info承载全部配置数据，建议纳入日常备份；升级版本前先mysqldump留一份。

到这里，No DataSource set这条启动报错应该已经解决或缩小到很小范围了。如果还是起不来，把logs/nacos.log里完整的Caused by链条整理出来，再去 Nacos 社区提问，会比只贴一行报错快得多。

【免费下载链接】nacosan easy-to-use dynamic service discovery, configuration and service management platform for building AI cloud native applications.项目地址: https://gitcode.com/GitHub_Trending/na/nacos