如何为本地Helidon Java应用启用HTTPS并配置SSL？

问题场景 #

作为Helidon新手，希望Java REST应用支持HTTPS。现有返回字符串的测试控制器，当前应用运行在http://localhost:8080，已生成自签名证书并在application.yaml中配置，但访问HTTPS端点时提示“This site can’t provide a secure connection”。

测试控制器代码：

@Path("/test")
@ApplicationScoped
public class TestEndpointController {

    @GET
    public Response executeRule() {
        return Response.status(200).entity("Working").build();
    }
}

已尝试的配置（存在缩进错误）：

server:
 port: 8080
  host: 0.0.0.0
  ssl:
    private-key:
      keystore-resource-path: "keystore.p12"
      keystore-passphrase: "changeit"
  experimental:
    http2:
      enable: true
      max-content-length: 16384

生成证书命令：

keytool -genkeypair -alias localhost -keyalg RSA -keysize 2048 -storetype PKCS12 -keystore keystore.p12 -validity 365

错误排查与修复步骤 #

1. 修正YAML配置缩进问题 #

YAML对缩进敏感，原配置中host、ssl等节点缩进错误，导致配置未生效。同时需显式启用SSL，并将HTTPS端口改为标准的8443（避免与HTTP端口冲突）。

正确的application.yaml配置：

server:
  port: 8443
  host: 0.0.0.0
  ssl:
    enabled: true  # 显式启用SSL
    private-key:
      keystore-resource-path: "keystore.p12"
      keystore-passphrase: "changeit"
      keystore-type: PKCS12  # 指定密钥库类型，与生成的证书一致
  experimental:
    http2:
      enable: true
      max-content-length: 16384

2. 确保证书文件位置正确 #

将生成的keystore.p12放置在项目的src/main/resources目录下，确保Helidon能加载到该资源。若放在其他路径，需调整keystore-resource-path为对应的相对路径或绝对路径。

3. 处理自签名证书的浏览器信任问题 #

自签名证书未被浏览器信任，访问时会提示安全错误，可通过以下方式解决：

• 浏览器手动信任：在浏览器的证书错误页面选择“高级”，然后选择“继续访问localhost”（不同浏览器操作略有差异）。
• 导入证书到系统信任库：
  1. 从keystore.p12中导出证书：

     keytool -exportcert -alias localhost -keystore keystore.p12 -storetype PKCS12 -file localhost.cer -storepass changeit
     

  2. 将导出的localhost.cer导入到浏览器或操作系统的信任证书库中。

4. 验证HTTPS访问 #

启动应用后，访问https://localhost:8443/test，若配置正确，将返回Working字符串。

可选：同时支持HTTP和HTTPS #

若需要同时提供HTTP和HTTPS服务，可配置双端口：

server:
  ports:
    - port: 8080
      host: 0.0.0.0
      ssl:
        enabled: false
    - port: 8443
      host: 0.0.0.0
      ssl:
        enabled: true
        private-key:
          keystore-resource-path: "keystore.p12"
          keystore-passphrase: "changeit"
          keystore-type: PKCS12

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