本文详解 android 真机如何安全、稳定地访问同一局域网内的本地 apache 服务器（如 xampp），涵盖网络配置、https/http 适配、volley 请求实践及关键避坑要点。
本文详解 android 真机如何安全、稳定地访问同一局域网内的本地 apache 服务器（如 xampp），涵盖网络配置、https/http 适配、volley 请求实践及关键避坑要点。
在 Android 开发初期，许多开发者会遇到一个典型场景：后端已用 XAMPP 搭建好本地 PHP + MySQL 服务（例如 http://192.168.56.172/api/login.php），手机与开发机处于同一 Wi-Fi 热点下，浏览器可正常访问该地址，但 App 发起 HTTP 请求时却失败——常见报错包括 java.net.MalformedURLException: no protocol 或更普遍的 Cleartext HTTP traffic not permitted。这并非代码逻辑错误，而是 Android 9（API 28）起强制启用的网络安全策略所致。
✅ 正确配置网络权限与安全策略
首先，确保使用的是局域网 IP（非 localhost 或 127.0.0.1）。在 Windows 上通过 ipconfig 查看本机 IPv4 地址（如 192.168.56.172），并确认 Apache 监听该地址（XAMPP 控制面板 → Config → httpd.conf 中检查 Listen 80 及
其次，必须显式声明允许明文流量的目标域名/IP。仅在 AndroidManifest.xml 中添加 android:usesCleartextTraffic="true" 是不够且不推荐的（尤其在生产环境或 Android 10+ 上可能被忽略）。正确做法是：
-
在 res/xml/network_security_config.xml 中精准配置目标地址：
<?xml version="1.0" encoding="utf-8"?> <network-security-config> <domain-config> <!-- 关键：此处必须包含你的局域网IP或自定义域名 --> <domain includeSubdomains="true">192.168.56.172</domain> <!-- 若使用 pagekite.me 域名，也需单独添加 --> <domain includeSubdomains="true">mohe.pagekite.me</domain> <cleartextTrafficPermitted>true</cleartextTrafficPermitted> </domain-config> </network-security-config> -
在 AndroidManifest.xml 的
标签中引用该配置： <application android:networkSecurityConfig="@xml/network_security_config" ... >
⚠️ 注意：
和 不能共存；若使用 ，必须将目标 IP/域名明确写入 标签，否则配置无效——这正是原问题中“添加了配置仍报错”的根本原因。
✅ Volley 请求示例（Kotlin）
以下为适配本地服务器的健壮请求代码（含基础错误处理与上下文绑定）：
val queue = Volley.newRequestQueue(this)
val url = "http://192.168.56.172/hello.php" // ✅ 使用局域网IP，非localhost
val stringRequest = StringRequest(
Request.Method.GET,
url,
{ response ->
val result = "Success: ${response.take(200)}"
Toast.makeText(this, result, Toast.LENGTH_LONG).show()
},
{ error ->
val errorMsg = when (error) {
is TimeoutError -> "请求超时，请检查网络和服务器状态"
is NoConnectionError -> "无法连接到服务器，请确认Apache已启动且IP正确"
else -> "请求失败: ${error.message}"
}
Toast.makeText(this, errorMsg, Toast.LENGTH_LONG).show()
}
).apply {
// 可选：设置超时时间（默认 2.5s，局域网建议延长）
setRetryPolicy(DefaultRetryPolicy(
5000, // timeoutMs
DefaultRetryPolicy.DEFAULT_MAX_RETRIES,
DefaultRetryPolicy.DEFAULT_BACKOFF_MULT
))
}
queue.add(stringRequest)✅ 其他关键注意事项
- 防火墙与端口开放：Windows 防火墙可能拦截外部设备对 80 端口的访问。请在「高级安全 Windows Defender 防火墙」中新建入站规则，允许 TCP 端口 80（或你自定义的端口）。
-
Apache 绑定配置：默认 XAMPP 的 httpd.conf 可能仅监听 127.0.0.1。修改为 Listen 80 并确保
下的 Require all granted 已启用。 - 避免 PageKite 等公网隧道用于开发：虽然可行，但引入额外延迟与不稳定因素。局域网直连才是高效开发的标准方案。
- 进阶建议：长期开发推荐启用 HTTPS（如 mkcert 生成本地证书），一劳永逸规避明文限制，并提前适配未来 Android 版本要求。
至此，你的 Android 真机即可稳定调用本地 XAMPP 提供的 PHP 接口，实现登录、数据读写等核心功能，大幅提升本地迭代效率。记住：可访问 ≠ 可通信，Android 的网络安全模型要求你主动声明信任边界——这是安全设计，而非障碍。
