<think>我们正在讨论
Android WebView中的错误处理，具体是关于`
onReceivedError`回调中的错误码
-1（net
::ERR_FAILED）和
-6。
这些错误码对应不同的网络错误情况。让我们详细解释这两个错误码以及如何处理它们。
1. **错误码
-1 (net
::ERR_FAILED)**：
这是一个通用的
失败错误，可能由多种原因引起，例如：
- 无效的URL
- 无法解析的域名（DNS问题）
- 服务器连接
失败
- SSL证书错误
- 没有网络连接（但通常会有更具体的错误码）
2. **错误码
-6 (net
::ERR_FILE_NOT_FOUND)**：
这个错误通常表示请求的资源在服务器上不存在（HTTP 404错误）或者WebView试图加载本地文件时文件不存在。
在WebView中，我们可以通过重写`WebViewClient`的`
onReceivedError`方法来捕获这些错误，并给用户展示自定义的错误页面或提示信息。
以下是一个处理这些错误的示例代码（使用Kotlin）：
</think>### 解决 WebView 错误 `
onReceivedError:-1 (net
::ERR_FAILED)` 和 `
onReceivedError:-6`
在
Android WebView 开发中，`
onReceivedError` 回调用于处理页面加载错误。以下是针对错误码 `
-1 (net
::ERR_FAILED)` 和 `
-6` 的解决方案：
#### 错误代码含义
1. **ERR_FAILED (
-1)**
: 通用网络请求
失败错误
- 原因：DNS解析
失败、服务器连接超时、SSL证书问题、服务器响应无效等
2. **ERR_FILE_NOT_FOUND (
-6)**
: 请求的资源不存在
- 原因：URL路径错误、服务器返回404、本地文件不存在等
#### 完整错误处理实现 (Kotlin)
```kotlin
class CustomWebViewClient
: WebViewClient() {
override fun
onReceivedError(
view
: WebView?,
request
: WebResourceRequest?,
error
: WebResourceError?
) {
super.
onReceivedError(view, request, error)
val
errorCode = error?.
errorCode ?
: -999
val
description = error?.
description ?
: "Unknown error"
val url = request?.url?.toString() ?
: "Unknown URL"
when (
errorCode) {
ERROR_FAILED
-> { //
-1
handleFailedError(view, url,
description)
}
ERROR_FILE_NOT_FOUND
-> { //
-6
handleFileNotFound(view, url,
description)
}
else
-> handleGenericError(view,
errorCode,
description)
}
}
private fun handleFailedError(
view
: WebView?,
url
: String,
description: CharSequence
) {
// 创建错误页面HTML内容
val errorHtml = """
<html>
<body>
<h2>连接
失败</h2>
<p>无法加载页面
: $url</p>
<p>错误原因
: $
description</p>
<button onclick="location.reload()">重新加载</button>
<button onclick="history.back()">返回上一页</button>
</body>
</html>
""".trimIndent()
view?.loadDataWithBaseURL(
null, errorHtml, "text/html", "UTF
-8", null
)
// 记录错误日志便于调试
Log.e("WebViewError", "ERR_FAILED
: $url
- $
description")
}
private fun handleFileNotFound(
view
: WebView?,
url
: String,
description: CharSequence
) {
val errorHtml = """
<html>
<body>
<h2>资源未找到</h2>
<p>请求的文件不存在
: $url</p>
<p>错误原因
: $
description</p>
<button onclick="history.back()">返回</button>
</body>
</html>
""".trimIndent()
view?.loadDataWithBaseURL(null, errorHtml, "text/html", "UTF
-8", null)
// 检查本地文件是否存在
if (url.startsWith("file
://")) {
val filePath = url.replace("file
://", "")
val file = File(filePath)
Log.w("WebViewError", "Local file exists
: ${file.exists()}
- $filePath")
}
}
private fun handleGenericError(
view
: WebView?,
errorCode: Int,
description: CharSequence
) {
// 处理其他类型的错误
Log.e("WebViewError", "Error $
errorCode: $
description")
}
}
```
#### 在 Activity 中使用
```kotlin
class MainActivity
: AppCompatActivity() {
override fun onCreate(savedInstanceState
: Bundle?) {
super.onCreate(savedInstanceState)
setContentView(R.layout.activity_main)
val webView
: WebView = findViewById(R.id.webView)
webView.settings.javaScriptEnabled = true
// 设置自定义WebViewClient
webView.webViewClient = CustomWebViewClient()
// 加载网页
webView.loadUrl("https
://your
-website.com")
}
}
```
### 错误处理策略详解
#### 1. ERR_FAILED (
-1) 解决方案
- **网络连接检查**：
```kotlin
val connectivityManager = getSystemService(Context.CONNECTIVITY_SERVICE) as ConnectivityManager
val activeNetwork = connectivityManager.activeNetworkInfo
val isConnected = activeNetwork?.isConnectedOrConnecting == true
```
- **SSL证书处理**：
```kotlin
override fun onReceivedSslError(
view
: WebView?,
handler
: SslErrorHandler?,
error
: SslError?
) {
// 生产环境应严格处理SSL错误
if (BuildConfig.DEBUG) {
handler?.proceed() // 仅调试模式忽略证书错误
} else {
handler?.cancel() // 生产环境取消加载
}
}
```
- **DNS解析
失败处理**：
```kotlin
// 在handleFailedError中添加DNS解析建议
val dnsHtml = """
<p>DNS解析
失败建议：</p>
<ul>
<li>检查网络连接</li>
<li>尝试切换网络(WiFi/移动数据)</li>
<li>等待网络恢复后重试</li>
</ul>
""".trimIndent()
```
#### 2. ERR_FILE_NOT_FOUND (
-6) 解决方案
- **本地文件路径验证**：
```kotlin
fun isValidLocalPath(path
: String)
: Boolean {
val file = File(path)
return file.exists() && file.canRead()
}
```
- **远程URL重试机制**：
```kotlin
private var retryCount = 0
private const val MAX_RETRY = 2
private fun handleFileNotFound(view
: WebView?, url
: String) {
if (retryCount < MAX_RETRY && url.startsWith("http")) {
retryCount++
view?.loadUrl(url) // 自动重试
} else {
// 显示错误页面
}
}
```
#### 高级调试技巧
1. **启用WebView调试**：
```kotlin
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT) {
WebView.setWebContentsDebuggingEnabled(true)
}
```
2. **网络请求监控**：
```kotlin
webView.webChromeClient = object
: WebChromeClient() {
override fun onConsoleMessage(consoleMessage
: ConsoleMessage)
: Boolean {
Log.d("WebViewConsole", "${consoleMessage.message()}")
return true
}
}
```
### 最佳实践建议
1. **错误分类处理**：
- 网络错误：提供重试按钮和网络设置入口
- 资源错误：显示替代内容或友好提示
- 证书错误：严格处理避免安全风险
2. **用户友好界面**：
- 自定义错误页面取代系统默认错误
- 提供操作按钮（重试/返回/刷新）
- 添加加载进度指示器
3. **错误日志收集**：
```kotlin
fun logWebError(
errorCode: Int, url
: String,
description: String) {
Firebase.crashlytics.log("WebViewError $
errorCode: $url")
Firebase.crashlytics.recordException(
WebViewException(
errorCode, url,
description)
)
}
```
本文介绍了遇到通过代理服务器进行身份验证失败的问题时，一种简单的解决方法：更换WiFi网络即可解决问题，避免了复杂的网络设置调整。
扫一扫
3968
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
