在Java中获取客户端局域网IP地址需要考虑应用部署环境，尤其是是否通过反向代理服务器（如Nginx、Apache）进行转发。以下是综合解决方案：

### 一、获取客户端真实IP地址的方法

**通过`X-Forwarded-For`头获取（推荐）**

当客户端请求经过反向代理服务器时，代理服务器会在HTTP头中添加`X-Forwarded-For`字段，包含原始客户端IP地址。示例代码：

```java

public String getClientIP(HttpServletRequest request) {

String ip = request.getHeader("X-Forwarded-For");

if (ip == null || "unknown".equalsIgnoreCase(ip)) {

ip = request.getHeader("Proxy-Client-IP");

}

if (ip == null || "unknown".equalsIgnoreCase(ip)) {

ip = request.getHeader("WL-Proxy-Client-IP");

}

return ip != null ? ip : request.getRemoteAddr();

}

```

*注意：需确保代理服务器正确配置了`X-Forwarded-For`头的传递。

**通过本地网络接口获取（局域网环境）**

在局域网内部，可通过`InetAddress.getLocalHost（）`获取本机IP地址，但此地址可能与客户端实际IP不同（如127.0.0.1或局域网IP）。示例代码：

```java

import java.net.InetAddress;

import java.net.NetworkInterface;

import java.net.SocketException;

public String getLocalIP() {

try {

InetAddress localhost = InetAddress.getLocalHost();

return localhost.getHostAddress();

} catch (SocketException e) {

e.printStackTrace();

return "127.0.0.1";

}

}

```

### 二、注意事项

**反向代理的配置**

若使用Nginx、Apache等代理服务器，需在配置文件中添加以下内容，以确保`X-Forwarded-For`头被正确传递：

- **Nginx** ：在`proxy_set_header`中添加`X-Forwarded-For $proxy_add_x_forwarded_for；`

- **Apache** ：在`.htaccess`中添加`RequestHeader set X-Forwarded-For %{REMOTE_ADDR}e；`（需启用`mod_headers`模块）

**处理特殊情况**

- 若未使用代理，直接调用`request.getRemoteAddr（）`即可获取客户端IP；

- 若客户端通过VPN或直接连接，可能需要其他方式获取IP（如数据库或第三方服务）。

**安全性考虑**

`X-Forwarded-For`头可能被伪造，建议结合其他验证机制（如用户认证）以确保IP地址的可靠性。

### 三、完整示例

以下是一个综合了上述方法的示例类：

```java

import javax.servlet.http.HttpServletRequest;

import java.net.InetAddress;

import java.net.NetworkInterface;

import java.net.SocketException;

public class IpUtil {

private static final String UNKNOWN = "unknown";

private static final String IPV6_LOCAL = "::1";

public static String getClientIP(HttpServletRequest request) {

String ip = request.getHeader("X-Forwarded-For");

if (ip == null || "unknown".equalsIgnoreCase(ip)) {

ip = request.getHeader("Proxy-Client-IP");

}

if (ip == null || "unknown".equalsIgnoreCase(ip)) {

ip = request.getHeader("WL-Proxy-Client-IP");

}

if (ip == null || ip.equals(IPV6_LOCAL)) {

ip = request.getRemoteAddr();

}

return ip;

}

public static String getLocalIP() {

try {

InetAddress localhost = InetAddress.getLocalHost();

return localhost.getHostAddress();

} catch (SocketException e) {

e.printStackTrace();

return "127.0.0.1";

}

}

}

```

通过上述方法，可灵活获取客户端IP地址，既适用于有代理的服务器环境，也能处理局域网内的请求。