cleartext HTTP traffic not permitted

解决Android 9.0 HTTP明文传输问题
本文详细介绍了在Android 9.0系统中,由于默认禁用未加密的HTTP请求,导致应用程序出现错误的情况。提供了两种解决方案:一是将HTTP升级为HTTPS;二是通过在应用清单文件中配置network_security_config,允许明文传输。

异常描述

在使用Android P(9.0)的机型上,如果我们的app使用的是Okhttp或HttpUrlConnection做网络请求时,会在logcat中报以下的错误.
cleartext HTTP traffic not permitted

原因

从android 9.0开始,网络请求默认不支持没有加密的明文传输.

解决方法

方法1

将http改为https.

方法2

在res/xml目录创建一个资源文件.
如果没有xml目录,先创建一个.

network_security_config.xml

<?xml version="1.0" encoding="utf-8"?>
<network-security-config>
    <domain-config cleartextTrafficPermitted="true"/>
</network-security-config>

在AndroidManifest.xml清单文件的Application标签中添加networkSecurityConfig属性,引用上面创建的

<?xml version="1.0" encoding="utf-8"?>
<manifest ... >
    <application android:networkSecurityConfig="@xml/network_security_config"
                    ... >
        ...
    </application>
</manifest>

这样我们的app就能正常的使用http请求了。

参考:https://stackoverflow.com/questions/45940861/android-8-cleartext-http-traffic-not-permitted
https://developer.android.google.cn/training/articles/security-config#CleartextTrafficPermitted

Android 9.0(Pie)及以上版本中,默认情况下系统禁止应用使用明文 HTTP 协议进行网络通信,以增强安全性。如果尝试通过 HTTP 向 `127.0.0.1` 或其他 IP 地址发送请求,将抛出异常:`java.io.IOException: Cleartext HTTP traffic to [127.0.0.1] not permitted` [^1]。 ### 解决方案 #### 1. 允许明文流量(Cleartext Traffic) 可以在 `AndroidManifest.xml` 文件的 `<application>` 标签中添加 `android:usesCleartextTraffic="true"` 属性,以允许应用对特定目标使用明文 HTTP 通信: ```xml <application android:usesCleartextTraffic="true"> </application> ``` 此配置允许应用在未加密的 HTTP 连接上进行通信,适用于测试环境或本地开发服务器 [^2]。 #### 2. 使用网络安全配置(Network Security Config) 为了更精细地控制网络通信策略,可以创建自定义的网络安全配置文件,并在 `AndroidManifest.xml` 中引用它: 在 `res/xml/network_security_config.xml` 中定义允许明文流量的规则: ```xml <?xml version="1.0" encoding="utf-8"?> <network-security-config> <domain-config cleartextTrafficPermitted="true"> <domain includeSubdomains="true">127.0.0.1</domain> </domain-config> </network-security-config> ``` 然后在清单文件中引用该配置: ```xml <application android:networkSecurityConfig="@xml/network_security_config"> </application> ``` 这种方式可以仅对特定域名或 IP 地址启用明文流量,而不影响其他网络请求的安全性 [^4]。 #### 3. 使用 HTTPS 替代 HTTP 更推荐的做法是使用 HTTPS 协议进行通信。可以为本地开发服务器配置 SSL 证书,以支持加密连接,从而避免 Android明文流量的限制。 #### 4. 使用 10.0.2.2 代替 127.0.0.1 在 Android 模拟器中,`127.0.0.1` 指向模拟器本身而非主机。如果在模拟器中访问主机本地服务器,应使用 `10.0.2.2` 作为 IP 地址。例如: ```java String url = "http://10.0.2.2:8080/api"; ``` 这样可以避免因地址解析问题导致的连接失败 [^2]。 --- ###
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值