在Java网络编程与Web开发中，准确获取域名和端口是构建动态链接、配置回调接口以及实现跨域资源共享的关键环节，核心上文归纳在于：开发者必须根据应用场景（是解析静态URL字符串还是处理Web请求）选择合适的API，并必须显式处理默认端口（80/443）以及反向代理环境下的头部信息，才能保证数据的准确性与系统的健壮性。 仅仅依赖基础API往往无法满足生产环境的需求,构建一个具备容错能力的工具类是解决此类问题的最佳实践。
基于标准库的URL字符串解析
在处理非Web容器的纯Java应用中，通常需要从一个完整的URL字符串中提取域名和端口，Java标准库提供了java.net.URL和java.net.URI两个核心类来处理此类需求。
使用java.net.URL类是最直观的方式，通过实例化URL对象，可以直接调用getHost()方法获取域名，调用getPort()方法获取端口号，这里存在一个极易被忽视的技术陷阱：当URL字符串中未显式指定端口号时（例如http://example.com/path），getPort()方法会返回-1，而不是默认的80或443端口，这在后续进行网络连接或字符串拼接时会导致异常，在获取端口时，必须编写逻辑判断：如果返回值为-1，则根据协议（getProtocol()）手动补充80（HTTP）或443（HTTPS）。
相比之下，java.net.URI类在解析严格性上表现更优，它专门用于解析URI的语法组件，虽然它同样存在端口未显式时返回-1的问题，但URI类在处理特殊字符编码和参数解析时更加规范，对于复杂的URL解析任务，优先推荐使用URI类进行预处理，再提取Host和Port信息,以避免因URL格式不规范导致的解析异常。
Web容器环境下的获取策略
在Spring Boot或Servlet等Web容器环境中，获取域名和端口的场景发生了变化，数据来源并非静态字符串，而是客户端发起的HttpServletRequest对象。
通过request.getServerName()可以获取服务器名称，request.getServerPort()可以获取服务器端口，在本地调试或直连生产环境时，这两个方法通常能返回正确的结果。现代Java Web应用几乎都部署在Nginx、云负载均衡（ELB/SLB）或API网关之后，在这种反向代理架构下，Web容器接收到的请求往往来自内网代理（如127.0.0.1:8080）,而非真实的客户端公网地址。
如果直接使用request.getServerName()，获取到的将是内网域名或IP，这会导致生成的回调地址或前端资源加载失败，为了解决这一问题，必须深入HTTP协议层面,检查特定的请求头信息。
处理反向代理与负载均衡的权威方案
为了在反向代理环境下获取真实的域名和端口，必须遵循“头部优先，回退本地”的原则,这是构建高可用Web系统的标准做法。
应检查X-Forwarded-Host请求头，这是业界通用的标准头部，用于记录原始请求的Host信息（通常包含域名和端口），如果该头存在，应优先解析其值，对于端口的获取，应检查X-Forwarded-Port头部，如果该头不存在，则需要从X-Forwarded-Host中解析端口，或者检查标准的Host头部。
值得注意的是，Host头部通常包含客户端请求的完整域名和端口（例如api.example.com:8443），在编写解析逻辑时，需要将Host字符串按冒号分割，分离出域名和端口部分，如果分割后只有一部分，说明使用了默认端口，需根据请求是否安全（request.isSecure()）来判断是80还是443。
专业级工具类实现
基于上述分析，以下提供一个符合生产环境标准的Java工具类方案，该方案整合了字符串解析、Web请求处理以及代理头部识别逻辑：
import javax.servlet.http.HttpServletRequest;
import java.net.URI;
import java.net.URISyntaxException;
public class NetworkUtil {
/**
* 从HttpServletRequest中获取真实的域名和端口
* 优先级：X-Forwarded-Host > Host > ServerName
*/
public static String getServerDomainWithPort(HttpServletRequest request) {
String host = request.getHeader("X-Forwarded-Host");
if (host == null || host.isEmpty()) {
host = request.getHeader("Host");
}
if (host == null || host.isEmpty()) {
host = request.getServerName();
int port = request.getServerPort();
// 处理默认端口不显示的逻辑
if ((request.isSecure() && port != 443) || (!request.isSecure() && port != 80)) {
return host + ":" + port;
}
return host;
}
return host;
}
/**
* 解析静态URL字符串获取端口，处理默认端口逻辑
*/
public static int parsePortFromUrl(String urlString) throws URISyntaxException {
URI uri = new URI(urlString);
int port = uri.getPort();
if (port == -1) {
return "https".equalsIgnoreCase(uri.getScheme()) ? 443 : 80;
}
return port;
}
}
上述代码中的getServerDomainWithPort方法展示了专业的处理流程：它首先尝试读取代理传递的真实Host，如果不存在则回退到请求头Host，最后才使用容器的ServerName，这种多层回退机制确保了无论应用是直接部署还是处于复杂的Kubernetes Ingress或Nginx代理之后,都能获取到正确的域名和端口信息。
相关问答
Q1：为什么在Java中使用URL.getPort()有时会返回-1，如何正确处理？
A1： 返回-1是因为URL字符串中省略了端口号，此时表示使用协议的默认端口，正确处理方式是判断返回值，当结果为-1时，根据URL的协议类型进行赋值：如果是HTTP协议，则端口视为80；如果是HTTPS协议，则端口视为443，切勿直接将-1用于网络连接。
Q2：在Nginx反向代理下，Java后端如何获取客户端访问的真实域名？
A2： Java后端不能直接依赖request.getServerName()，必须在Nginx配置中添加proxy_set_header Host $host;和proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;等指令，在Java代码中，优先通过request.getHeader("X-Forwarded-Host")或request.getHeader("Host")来获取真实域名,这样才能确保生成的重定向地址或资源链接是正确的公网地址。
如果您在处理复杂的网络架构获取域名端口时遇到其他问题，欢迎在评论区留言,我们一起探讨解决方案。
