Eclipse Scout项目连接MSSQL服务器TLS版本不兼容问题求助

角色确认 #

• 你的应用是客户端，MSSQL是服务器端：应用主动发起数据库连接请求，MSSQL作为服务端响应，所以需要调整客户端（Java应用）的TLS协议支持策略，允许使用TLS1.0。

问题根源 #

Java 17默认在安全配置中禁用了TLS1.0和TLS1.1，仅通过-Djdk.tls.client.protocols=TLSv1无法绕过这个限制，这就是你之前配置失效的核心原因。

分步解决 #

1. 修改JDK安全配置（必须步骤） #

找到Java Temurin 17的安装目录，打开conf/security/java.security文件，定位到jdk.tls.disabledAlgorithms配置项：

jdk.tls.disabledAlgorithms=SSLv3, TLSv1, TLSv1.1, RC4, DES, MD5withRSA, ...

将TLSv1从禁用列表中移除，保存文件。这一步是让JDK允许应用使用TLS1.0协议。

2. 正确添加JVM启动参数 #

这个参数需要配置到Java启动参数中，不同环境的配置位置如下：

• 本地Eclipse启动：在Run Configurations -> Arguments -> VM arguments中添加：

  -Djdk.tls.client.protocols=TLSv1,TLSv1.2,TLSv1.3
  

  （同时保留高版本TLS协议，避免影响其他HTTPS或数据库连接）
• Tomcat部署：
  • Linux系统：编辑Tomcat的bin/catalina.sh，添加：

    CATALINA_OPTS="$CATALINA_OPTS -Djdk.tls.client.protocols=TLSv1,TLSv1.2,TLSv1.3"
    

  • Windows系统：编辑bin/catalina.bat，添加：

    set CATALINA_OPTS=%CATALINA_OPTS% -Djdk.tls.client.protocols=TLSv1,TLSv1.2,TLSv1.3
    

• Docker部署：
  如果是直接运行Java应用的镜像，在Dockerfile中添加：

  ENV JAVA_OPTS="-Djdk.tls.client.protocols=TLSv1,TLSv1.2,TLSv1.3"
  ENTRYPOINT ["java", "-jar", "your-app.jar"]
  

  如果是Tomcat的Docker镜像，需调整CATALINA_OPTS：

  ENV CATALINA_OPTS="-Djdk.tls.client.protocols=TLSv1,TLSv1.2,TLSv1.3"
  

3. 检查JDBC连接URL #

确保你的MSSQL连接URL没有强制指定高版本TLS的参数，比如sslProtocol=TLSv1.2。如果有，移除该参数，让JDBC驱动自动与服务器协商合适的协议。示例正确URL：

jdbc:sqlserver://<server>:<port>;databaseName=<db>;encrypt=true;trustServerCertificate=true

错误原因说明 #

• 仅添加-Djdk.tls.client.protocols=TLSv1仍报错：因为JDK安全配置中TLS1.0被禁用，参数无法生效。
• 添加-Dhttps.protocols=TLSv1报错：该参数仅针对HTTPS连接，不适用于JDBC数据库连接，会导致协议不匹配。

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