能否配置Keycloak使用外部MySQL数据库，是否需自定义库与UserStorage SPI？

完全可行，而且根本不需要用到UserStorage SPI——这是Keycloak原生支持的核心配置场景，和自定义用户数据源的SPI完全无关。下面是具体操作步骤：

前置准备 #

• 先在你的localhost:8090 MySQL服务器上，手动创建一个空数据库（比如命名为keycloak_db），同时创建一个拥有该数据库全部操作权限的用户（比如keycloak_user），记好账号和密码。
• 下载和你的Keycloak版本兼容的MySQL JDBC驱动，放到Keycloak安装目录的providers文件夹下（如果是传统WildFly架构的旧版Keycloak，放到standalone/deployments目录）。

配置步骤（以Keycloak 17+ Quarkus版本为例） #

找到Keycloak安装目录下的conf/application.properties文件，添加或替换以下配置项：

# 指定数据库类型为MySQL
quarkus.datasource.db-kind=mysql
# MySQL连接URL，替换成你的数据库名和参数
quarkus.datasource.jdbc.url=jdbc:mysql://localhost:8090/keycloak_db?useSSL=false&characterEncoding=UTF-8&serverTimezone=UTC
# 数据库账号
quarkus.datasource.username=keycloak_user
# 数据库密码
quarkus.datasource.password=你的数据库密码
# 首次启动用create-drop自动建表，后续稳定运行可以改成update
quarkus.hibernate-orm.database.generation=create-drop

如果是传统WildFly版本的Keycloak，需要修改standalone/configuration/standalone.xml：

1. 找到<datasources>节点，替换默认的H2数据源为MySQL配置：

<datasource jndi-name="java:jboss/datasources/KeycloakDS" pool-name="KeycloakDS" enabled="true" use-java-context="true">
    <connection-url>jdbc:mysql://localhost:8090/keycloak_db?useSSL=false&characterEncoding=UTF-8&serverTimezone=UTC</connection-url>
    <driver>mysql</driver>
    <security>
        <user-name>keycloak_user</user-name>
        <password>你的数据库密码</password>
    </security>
</datasource>

2. 在<drivers>节点下添加MySQL驱动配置：

<driver name="mysql" module="com.mysql">
    <driver-class>com.mysql.cj.jdbc.Driver</driver-class>
    <xa-datasource-class>com.mysql.cj.jdbc.MysqlXADataSource</xa-datasource-class>
</driver>

3. 还需要在modules/system/layers/base/com/mysql/main目录下创建模块结构，放入MySQL驱动jar包和module.xml配置文件（模块配置逻辑是声明驱动的依赖，确保WildFly能加载到）。

启动验证 #

首次启动Keycloak时，它会自动在你创建的keycloak_db数据库中生成所有所需的表结构和初始数据，不需要手动建表。启动后正常访问Keycloak控制台，就说明数据库切换成功了。

关于UserStorage SPI的说明 #

这个SPI是用来对接非标准用户数据源的（比如企业内部LDAP、自定义用户管理数据库），作用是让Keycloak从外部数据源读取用户信息，而不是替换Keycloak自身的存储数据库。你的需求完全用不上这个功能。

内容的提问来源于stack exchange，提问作者stacktrace2234