Jetty配置域名后访问失败，如何排查并解决？

在Java Web应用开发中，Jetty作为一个轻量级且高性能的Servlet容器，因其灵活性和易用性被广泛采用，当需要将Jetty部署到生产环境或通过特定域名访问应用时，正确的域名配置至关重要，本文将详细介绍Jetty域名的配置方法，涵盖基础概念、配置步骤、常见问题及解决方案，帮助开发者顺利完成域名绑定。

域名配置的基础概念

在开始配置之前,需要理解几个关键概念，域名配置的本质是将特定的域名或子域名指向Jetty服务器监听的IP地址和端口，并通过虚拟主机（Virtual Host）机制实现不同域名的请求隔离，Jetty支持两种主要的网络连接方式：HTTP和HTTPS，因此域名配置也需分别处理，虚拟主机的配置允许在同一台服务器上运行多个独立域名的Web应用，每个域名对应不同的Web应用上下文。

HTTP域名的配置步骤

修改Jetty的HTTP配置文件

Jetty的HTTP连接器通常在etc/jetty-http.xml文件中定义，打开该文件，找到<Configure id="Server" class="org.eclipse.jetty.server.Server">节点下的<New id="httpConfig" class="org.eclipse.jetty.server.HttpConfiguration">配置，确保其中的<SendServerVersion>false</SendServerVersion>被注释或设置为false，以避免暴露服务器版本信息。

配置HTTP连接器

在etc/jetty-http.xml中，添加或修改HTTP连接器的配置，明确指定监听的IP地址和端口，若需监听所有网络接口（0.0.0.0）的80端口，配置如下：

<Call name="addConnector">
  <Arg>
    <New class="org.eclipse.jetty.server.ServerConnector">
      <Arg name="server"><Ref id="Server"/></Arg>
      <Arg name="factories"><Array type="org.eclipse.jetty.server.ConnectionFactory">
        <Item><New class="org.eclipse.jetty.server.HttpConnectionFactory">
          <Arg name="httpConfig"><Ref id="httpConfig"/></Arg>
        </New></Item>
      </Array></Arg>
      <Set name="host">0.0.0.0</Set>
      <Set name="port">80</Set>
    </New>
  </Arg>
</Call>

设置虚拟主机

在etc/jetty.xml或应用的WEB-INF/jetty-web.xml中配置虚拟主机，以jetty.xml为例，添加以下内容：

<Call name="addVirtualHost">
  <Arg>www.example.com</Arg>
</Call>

若需支持多个域名,可重复调用addVirtualHost方法，确保Web应用的web.xml中配置了<welcome-file-list>等基础设置，以便正确处理根路径请求。

重启Jetty服务

完成配置后,重启Jetty服务器使配置生效，通过浏览器访问http://www.example.com，若能正确显示应用内容，则说明HTTP域名配置成功。

HTTPS域名的配置步骤

对于需要加密传输的场景,HTTPS域名的配置必不可少，以下是详细步骤：

准备SSL证书

首先需要获取SSL证书,可从权威机构（如Let’s Encrypt）购买或申请免费证书，将证书文件（如example.crt）和私钥文件（如example.key）放置在Jetty的etc/ssl目录下。

配置HTTPS连接器

在etc/jetty-https.xml中配置HTTPS连接器，指定证书路径、密码及监听端口（默认443）：

<Call name="addConnector">
  <Arg>
    <New class="org.eclipse.jetty.server.ServerConnector">
      <Arg name="server"><Ref id="Server"/></Arg>
      <Arg name="factories"><Array type="org.eclipse.jetty.server.ConnectionFactory">
        <Item><New class="org.eclipse.jetty.server.SslConnectionFactory">
          <Arg name="sslContextFactory"><Ref id="sslContextFactory"/></Arg>
          <Arg name="protocol">HTTP/1.1</Arg>
        </New></Item>
        <Item><New class="org.eclipse.jetty.server.HttpConnectionFactory">
          <Arg name="httpConfig"><Ref id="httpConfig"/></Arg>
        </New></Item>
      </Array></Arg>
      <Set name="host">0.0.0.0</Set>
      <Set name="port">443</Set>
    </New>
  </Arg>
</Call>

配置SSL上下文工厂

在etc/jetty-https.xml中添加SSL上下文工厂配置：

<New id="sslContextFactory" class="org.eclipse.jetty.util.ssl.SslContextFactory">
  <Set name="keyStorePath"><Property name="jetty.base" default="."/>/etc/ssl/example.jks</Set>
  <Set name="keyStorePassword">changeit</Set>
  <Set name="keyManagerPassword">changeit</Set>
  <Set name="trustStorePath"><Property name="jetty.base" default="."/>/etc/ssl/truststore.jks</Set>
  <Set name="trustStorePassword">changeit</Set>
  <Set name="needClientAuth">false</Set>
  <Set name="wantClientAuth">false</Set>
  <Set name="excludeCipherSuites">
    <Array type="java.lang.String">
      <Item>SSL_RSA_WITH_DES_CBC_SHA</Item>
      <Item>SSL_DHE_RSA_WITH_DES_CBC_SHA</Item>
      <Item>SSL_RSA_EXPORT_WITH_RC4_40_MD5</Item>
      <Item>SSL_RSA_EXPORT_WITH_DES40_CBC_SHA</Item>
    </Array>
  </Set>
</New>

注意：若使用PEM格式的证书和私钥，需通过keyStorePath指向包含证书链的PKCS12或JKS文件，或使用setKeyStoreType("PKCS12")并指定相应路径。

配置HTTPS虚拟主机

与HTTP类似,在jetty.xml中为HTTPS域名添加虚拟主机配置：

<Call name="addVirtualHost">
  <Arg>secure.example.com</Arg>
</Call>

重启Jetty并测试

重启Jetty服务器后,通过https://secure.example.com访问，若浏览器显示安全锁图标，则HTTPS域名配置成功。

常见问题及解决方案

访问域名时出现404错误

原因：虚拟主机配置错误或Web应用上下文路径未正确设置。
解决：检查jetty.xml中的虚拟主机配置是否包含目标域名，并确认Web应用的contextPath设置是否正确。

HTTPS访问提示证书不受信任

原因：证书未正确安装或证书链不完整。
解决：验证证书文件路径是否正确，确保证书链包含中间证书（如Let’s Encrypt的证书需包含ISRG Root X1证书）。

域名无法访问

原因：DNS解析错误或防火墙阻止端口访问。
解决：使用nslookup或dig命令检查域名是否正确解析到服务器IP，并确保服务器的防火墙（如iptables、firewalld）允许80和443端口的入站流量。

Jetty启动时端口被占用

原因：80或443端口被其他程序占用。
解决：通过netstat -tuln | grep :80命令检查端口占用情况，修改Jetty配置中的端口号或停止占用端口的程序。

高级配置与优化

配置多个虚拟主机

若需在同一Jetty实例中支持多个域名,只需为每个域名重复配置虚拟主机，并为每个域名关联不同的Web应用上下文。

<Call name="addVirtualHost">
  <Arg>site1.example.com</Arg>
</Call>
<Call name="addVirtualHost">
  <Arg>site2.example.com</Arg>
</Call>

强制HTTPS重定向

为确保所有HTTP请求自动跳转至HTTPS,可在Web应用的web.xml中添加安全约束：

<security-constraint>
  <web-resource-collection>
    <web-resource-name>Entire Application</web-resource-name>
    <url-pattern>/*</url-pattern>
  </web-resource-collection>
  <user-data-constraint>
    <transport-guarantee>CONFIDENTIAL</transport-guarantee>
  </user-data-constraint>
</security-constraint>

配置HTTP/2支持

Jetty 9.4及以上版本支持HTTP/2，需在HTTPS连接器中添加ALPN协议支持：

<Set name="EnableHttp2">true</Set>
<Set name="Http2CleartextPort">8443</Set>

Jetty域名的配置涉及HTTP/HTTPS连接器、虚拟主机、SSL证书等多个环节，需根据实际需求逐步调整，通过本文介绍的步骤和解决方案，开发者可以顺利完成域名绑定，确保应用能够通过自定义域名稳定、安全地访问，在实际操作中，建议结合Jetty官方文档和具体场景进行测试，以优化配置的稳定性和性能。