Android连接本地Apache服务器教程

本文手把手教你如何让Android真机在局域网内安全、稳定地访问本地Apache服务器（如XAMPP），直击开发中“浏览器能打开但App请求失败”的经典痛点，深入解析Android 9+强制启用的明文流量限制机制，提供精准的network_security_config配置方案、Volley请求实战代码、防火墙与Apache绑定关键设置，并附上超实用避坑指南和HTTPS进阶建议——掌握这些，你就能告别连接报错，高效完成前后端联调。

本文详解 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 及 权限）。手机浏览器输入 http://192.168.56.172 能打开即说明服务可达。

其次，必须显式声明允许明文流量的目标域名/IP。仅在 AndroidManifest.xml 中添加 android:usesCleartextTraffic="true" 是不够且不推荐的（尤其在生产环境或 Android 10+ 上可能被忽略）。正确做法是：

1. 在 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>

2. 在 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 的网络安全模型要求你主动声明信任边界——这是安全设计，而非障碍。

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~