Android Java UDP Socket抛出Already Bound异常排查（未绑定端口）

核心原因 #

你遇到的java.net.SocketException: Already Bound异常，本质是无参DatagramSocket()构造方法会自动完成绑定操作：调用这个构造时，系统会自动将Socket绑定到一个随机的本地端口，后续再手动调用bind()就会触发重复绑定的错误——这个问题和端口是否被其他程序占用无关，哪怕设备刚冷启动也会触发。

正确的代码写法 #

要实现指定端口绑定并开启广播/复用地址，需先创建未绑定的DatagramSocket实例，再配置参数最后执行绑定，有两种可行方式：

方式1：先创建未绑定Socket再配置绑定（推荐） #

// 创建未绑定的Socket实例
discoverSocket = new DatagramSocket(null);
discoverSocket.setBroadcast(true);
discoverSocket.setReuseAddress(true);
discoverSocket.setSoTimeout(100);
// 绑定到指定端口
discoverSocket.bind(new InetSocketAddress("0.0.0.0", DISCOVER_LOCAL_PORT));

方式2：直接通过构造方法完成绑定 #

如果不需要中途修改参数，也可以直接在构造阶段绑定到指定端口：

InetSocketAddress bindAddr = new InetSocketAddress("0.0.0.0", DISCOVER_LOCAL_PORT);
discoverSocket = new DatagramSocket(bindAddr);
discoverSocket.setBroadcast(true);
discoverSocket.setReuseAddress(true);
discoverSocket.setSoTimeout(100);

额外注意事项 #

• 端口复用生效条件：setReuseAddress(true)必须在Socket绑定前设置才会生效，这也是优先创建未绑定实例的原因之一。
• Android权限补充：针对Android 10及以上版本，若需在后台使用UDP广播，除已申请的权限外，还需申请ACCESS_COARSE_LOCATION或ACCESS_FINE_LOCATION权限，且要确保用户已授予该动态权限。
• 模拟器测试提示：Android模拟器网络与宿主机隔离，测试UDP广播时需使用模拟器特殊网络配置（如用10.0.2.2访问宿主机，或开启网络桥接模式）。

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