🧑 博主简介：CSDN博客专家，历代文学网（PC端可以访问：https://literature.sinhy.com/#/?__c=1000，移动端可微信小程序搜索“历代文学”）总架构师，
15年工作经验，精通Java编程，高并发设计，Springboot和微服务，熟悉Linux，ESXI虚拟化以及云原生Docker和K8s，热衷于探索科技的边界，并将理论知识转化为实际应用。保持对新技术的好奇心，乐于分享所学，希望通过我的实践经历和见解，启发他人的创新思维。在这里，我希望能与志同道合的朋友交流探讨，共同进步，一起在技术的世界里不断学习成长。
技术合作请加本人wx（注明来自csdn）：foreast_sea
Nacos-3.0.3 适配PostgreSQL数据库
引言
本文重点介绍基于Nacos-3.0.3最新版本如何用PostgreSQL数据库来存储，也就是如何打造或直接获取能适配Nacos-3.0.3的PostgreSQL数据库插件。
Nacos-3.0.3版本最直接最快集成PostgreSQL数据源的方法就是引入依赖，这也是本文重点，也就是核心部分，我把它放这里：
<dependency>
<groupId>com.sinhy</groupId>
<artifactId>nacos-postgresql-datasource-plugin-ext</artifactId>
<version>3.0.3</version>
</dependency>
我已将pg数据源插件打成了jar包，传到maven中央仓库，大家只需下载该jar，然后放入nacos的home目录下的plugins插件目录，再配置pg数据源信息，即可使用！
一、PostgreSQL数据库源码地址
为了方便后续及时更新Nacos每个版本对应的PostgreSQL数据库插件，我们特意基于官方提供的Nacos插件工程进行了二开，然后打算后续自己维护这部分功能，因此给大家分享：
Nacos-3.0.3的PostgreSQL数据库插件源码地址
https://github.com/lilinhai/nacos-datasource-plugin-ext
注意：目前该工程中，只有PostgreSQL插件可以正常使用，其余数据库暂未做相关深入适配和测试！
二、灰度配置适配
增加了一个抽象类，用于适配其他数据库多灰度配置表的支持：
public abstract class BaseConfigInfoGrayMapper extends AbstractDataSourceMapper implements ConfigInfoGrayMapper
{
/**
* <pre>构造方法</pre>
* @since 2025-04-27 10:03
* @param databaseDialect
*/
protected BaseConfigInfoGrayMapper(DatabaseDialect databaseDialect)
{
super(databaseDialect);
}
@Override
public String getTableName()
{
return TableConstant.CONFIG_INFO_GRAY;
}
@Override
public MapperResult findAllConfigInfoGrayForDumpAllFetchRows(MapperContext context)
{
String sql = " SELECT id,data_id,group_id,tenant_id,gray_name,gray_rule,app_name,content,md5,gmt_modified " + " FROM config_info_gray ORDER BY id ";
sql = databaseDialect.getLimitPageSqlWithOffset(sql, context.getStartRow(), context.getPageSize());
return new MapperResult(sql, Collections.emptyList());
}
}
三、源码打包构建
源码下载本地后，也可以手动打包构建，输出pg插件，如下图：
执行maven构建命令：
clean package
将输出jar到target目录下：
将jar拷贝到nacos的plugins目录下即可
四、nacos3.0 基于pg启动
启动需要输入安全密钥：
输入后回车、即可访问8080（管理端口）端口：
五、插件概述
5.1、简介
从Nacos2.2版本开始，Nacos提供了数据源扩展插件，以便让需要进行其他数据库适配的用户自己编写插件来保存数据。当前项目插件目前已简单适配Postgresql。
当前插件项目地址：
https://github.com/lilinhai/nacos-datasource-plugin-ext
当前项目是基于Nacos3.0.1版本的扩展插件口进行开发，同时也是基于以下项目的一个分支进行的而开：
https://github.com/nacos-group/nacos-plugin/tree/develop/nacos-datasource-plugin-ext
很感谢阿里nacos团队的贡献，你们一如既往的迭代nacos版本，给你们说声辛苦了，但是却忘记了nacos的其他数据源适配，比如postgresql。
5.2、插件工程结构说明
nacos-datasource-plugin-ext-base工程为数据库插件操作的适配抽象定义。
nacos-postgresql-datasource-plugin-ext工程可打包适配Postgresql的数据库插件
六、下载和使用
6.1、插件引入
方式一：将nacos的postgresql插件下载下来，将依赖手动拷贝到nacos的home目录下的plugins目录下（nacos-3.0.1/plugins）即可。
- 以下
nacos的postgresql插件版本仅支持nacos3.0.1，采用jdk17编译级：
<dependency>
<groupId>com.sinhy</groupId>
<artifactId>nacos-postgresql-datasource-plugin-ext</artifactId>
<version>3.0.2</version>
</dependency>
方式二：下载当前插件项目源码，打包为jar包，将该文件的路径配置到startup.sh文件中，使用Nacos的loader.path机制指定该插件的路径，可修改startup.sh中的loader.path参数的位置进行指定。
6.2、修改数据库配置文件
在application.properties文件中声明postgresql的配置信息：
spring.sql.init.platform=postgresql
#spring.datasource.platform=postgresql
### Count of DB:
db.num=1
### Connect URL of DB:
db.url.0=jdbc:postgresql://127.0.0.1:5432/nacos?currentSchema=public&useUnicode=true&tcpKeepAlive=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai&reWriteBatchedInserts=true&ApplicationName=nacos_java
db.user.0=nacos
db.password.0=nacos
db.pool.config.connectionTimeout=30000
db.pool.config.validationTimeout=10000
db.pool.config.maximumPoolSize=20
db.pool.config.minimumIdle=2
db.pool.config.driverClassName=org.postgresql.Driver
# 如果是 oracle 则需要改为 SELECT * FROM dual
# db.pool.config.connectionTestQuery=SELECT 1
6.3、导入Postgresql的数据库脚本文件
导入nacos-postgresql的脚本文件，脚本文件在nacos-postgresql-datasource-plugin-ext/src/main/resources/schema文件夹下面.
上面操作完成后，启动Nacos即可。
七、其他数据库插件开发
可参考nacos-postgresql-datasource-plugin-ext工程，新创建Maven项目，实现AbstractDatabaseDialect类，重写相关的分页操作逻辑与方法，并创建相应的mapper实现。
八、参考资料
https://github.com/nacos-group/nacos-plugin/tree/develop/nacos-datasource-plugin-ext