Keycloak 19.0.1部署于Azure App Service连接SQL Server驱动缺失问题

我使用quay.io/keycloak/keycloak:19.0.1镜像在Azure App Service部署了Keycloak 19，使用开发文件数据库时运行正常，但切换到SQL Server数据库时出现问题。已按照Keycloak官方数据库配置文档操作，仍报错：

ERROR [org.keycloak.quarkus.runtime.cli.ExecutionExceptionHandler] (main) ERROR: No suitable driver found for jdbc:sqlserver://MySDBServer:1433;databaseName=MyDatabaseName

当前应用设置配置如下：

• KC_DB: mssql
• KC_DB_URL_HOST: [MyDatabaseServer]
• KC_DB_PASSWORD: [MyDatabasePassword]
• KC_DB_USERNAME: [MyDatatabaseUsername]
• KC_DB_URL_DATABASE: [MydatabaseName]
• KC_PROXY: edge

问题原因及解决办法 #

1. 缺失SQL Server JDBC驱动
   Keycloak 19官方镜像默认未包含SQL Server的JDBC驱动，这是报错的核心原因。需通过以下方式添加：

• 自定义镜像：基于官方镜像构建，在Dockerfile中加入驱动下载步骤，示例：

FROM quay.io/keycloak/keycloak:19.0.1
USER root
RUN curl -L -o /opt/keycloak/providers/mssql-jdbc-12.4.1.jre11.jar https://repo1.maven.org/maven2/com/microsoft/sqlserver/mssql-jdbc/12.4.1.jre11/mssql-jdbc-12.4.1.jre11.jar
USER keycloak

构建完成后，用自定义镜像重新部署到Azure App Service。

2. 补全连接参数与网络配置

• 若SQL Server使用非默认端口（1433），需添加KC_DB_URL_PORT配置项指定端口；
• 检查SQL Server防火墙规则，确保Azure App Service的出站IP已被允许访问数据库实例。

3. 手动指定完整JDBC URL
   若自动生成的URL存在异常，可直接设置KC_DB_URL覆盖默认生成值，示例：
   KC_DB_URL: jdbc:sqlserver://MyDatabaseServer:1433;databaseName=MyDatabaseName;encrypt=true;trustServerCertificate=true
   （根据SQL Server加密要求调整encrypt和trustServerCertificate参数）

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