add README exception

atptro · sjj3086786 · commit ef6f333a0b3c · 2019-04-11T16:50:03.000+08:00
diff --git a/README-CN.md b/README-CN.md
@@ -102,7 +102,7 @@ public class Main {
 * [代理配置](./docs/6-Proxy-CN.md)
 * [调试](./docs/7-Debug-CN.md)
 * [日志](./docs/8-Log-CN.md)
-
+* [异常](./docs/9-Exception-CN.md)
 
 ## 问题
 [提交 Issue](https://github.com/aliyun/aliyun-openapi-java-sdk/issues/new)，不符合指南的问题可能会立即关闭。
diff --git a/README.md b/README.md
@@ -114,6 +114,7 @@ public class Main {
 * [Proxy Configurations](./docs/6-Proxy-EN.md)
 * [Debug](./docs/7-Debug-EN.md)
 * [Log](./docs/8-Log-EN.md)
+* [Exception](./docs/9-Exception-EN.md)
 
 
 ## Issues
@@ -133,4 +134,4 @@ Please make sure to read the [Contributing Guide](CONTRIBUTING.md) before making
 ## License
 [Apache-2.0](http://www.apache.org/licenses/LICENSE-2.0)
 
-Copyright 1999-2019 Alibaba Group Holding Ltd.
+Copyright 1999-2019 Alibaba Group Holding Ltd.
diff --git a/docs/2-Client-CN.md b/docs/2-Client-CN.md
@@ -74,7 +74,7 @@ access_key_secret = bar
 role_arn = role_arn
 role_session_name = session_name   # 选填
 
-[client3]                          # 命名为 `client4` 的配置
+[client3]                          # 命名为 `client3` 的配置
 type = rsa_key_pair                # 认证方式为 rsa_key_pair
 public_key_id = publicKeyId        # Public Key ID
 private_key_file = /your/pk.pem    # Private Key 文件
@@ -149,4 +149,4 @@ public class Main {
 ```
 
 ***
-[← 安装](1-Installation-CN.md) | 客户端[(English)](2-Client-EN.md) | [连接池 →](3-Pool-CN.md)
+[← 安装](1-Installation-CN.md) | 客户端[(English)](2-Client-EN.md) | [连接池 →](3-Pool-CN.md)
diff --git a/docs/8-Log-CN.md b/docs/8-Log-CN.md
@@ -1,4 +1,4 @@
-[← 调试](7-Debug-CN.md) | 日志[(English)](8-Log-EN.md) | [首页 →](../README-CN.md)
+[← 调试](7-Debug-CN.md) | 日志[(English)](8-Log-EN.md) | [异常 →](9-Exception-CN.md)
 ***
 
 
@@ -57,4 +57,4 @@ clientConfig.setLogFormat(format)
 | {time}     | 日志记录时间 |
 
 ***
-[← 调试](7-Debug-CN.md) | 日志[(English)](8-Log-EN.md) | [首页 →](../README-CN.md)
+[← 调试](7-Debug-CN.md) | 日志[(English)](8-Log-EN.md) | [异常 →](9-Exception-CN.md)
diff --git a/docs/8-Log-EN.md b/docs/8-Log-EN.md
@@ -1,4 +1,4 @@
-[← Debug](7-Debug-EN.md) | Log[(中文)](8-Log-CN.md) |[Home →](../README.md)
+[← Debug](7-Debug-EN.md) | Log[(中文)](8-Log-CN.md) |[Exception →](9-Exception-EN.md)
 
 ***
 
@@ -56,4 +56,4 @@ The following variable substitutions are supported:
 | {time}     | Log Time |
 
 ***
-[← Debug](7-Debug-EN.md) | Log[(中文)](8-Log-CN.md) |[Home →](../README.md)
+[← Debug](7-Debug-EN.md) | Log[(中文)](8-Log-CN.md) |[Exception →](9-Exception-EN.md)
diff --git a/docs/9-Exception-CN.md b/docs/9-Exception-CN.md
@@ -0,0 +1,51 @@
+[← 日志](8-Log-CN.md) | 异常[(English)](9-Exception-EN.md) | [首页 →](../README-CN.md)
+***
+
+# 问题
+
+| 异常信息              |   解决办法       |
+|----------------------|------------------|
+| content has not been provided     | 升级到最新版本 |
+| ExceptionInInitializerError |升级到最新版本|
+| NoClassDefFoundError |添加缺少的依赖包|
+| SocketTimeoutException has occurred on a socket read or accept. |设置合理的超时时间|
+| Specified signature nonce was used already. |升级到最新版本|
+| NoSuchMethodError |添加缺少的依赖包|
+| MissingSecurityToken | 升级到最新版本 |
+| Specified access key is not found |[检查AK的正确性](#Specified-access-key-is-not-found)|
+| An invalid XML character (Unicode: 0x8) was found in the element content of the document |[验证xml是否合法](#xml-character)|
+| Server response has a bad format type    | [更多](#Server-response-has-a-bad-format-type) |
+
+## Specified access key is not found
+
+原因及解决方案：
+
+ 1. Ak 没有相应的权限，联系对应的管理获取权限
+ 2. Ak 填写错误，请认证检查 AK 是否正确
+ 3. 使用环境不匹配，请确认当前环境下 AK 是真实有效的
+ 
+## Server response has a bad format type
+
+原因及解决方案：
+
+返回的 http 协议没有指定数据格式
+
+1. 设置 `request.setAcceptFormat(FormatType.JSON)` 如果无法解决在使用第二个方案
+2. 使用 `HttpResponse response = client.doAction(request)` 接收返回
+
+## xml character
+
+原因及解决方案：
+
+[官方文档说明](https://www.w3.org/TR/2000/REC-xml-20001006#NT-Char)
+
+以下三段为非法字符，请不要在xml中出现
+
+ 1. 0x00 - 0x08
+ 2. 0x0b - 0x0c
+ 3. 0x0e - 0x1f
+
+
+
+***
+[← 日志](8-Log-CN.md) | 异常[(English)](9-Exception-EN.md) | [首页 →](../README-CN.md)
diff --git a/docs/9-Exception-EN.md b/docs/9-Exception-EN.md
@@ -0,0 +1,49 @@
+[← Log](8-Log-EN.md) | Exception[(中文)](9-Exception-CN.md) |[Home →](../README.md)
+***
+
+# Questions
+
+| exception               |    solutions      |
+|----------------------|------------------|
+| content has not been provided     | Upgrade to the latest version |
+| ExceptionInInitializerError |Upgrade to the latest version|
+| NoClassDefFoundError |Add missing dependency packages|
+| SocketTimeoutException has occurred on a socket read or accept. |Set a reasonable timeout|
+| Specified signature nonce was used already. |Upgrade to the latest version|
+| NoSuchMethodError |Add missing dependency packages|
+| MissingSecurityToken | Upgrade to the latest version |
+| Specified access key is not found |[heck the correctness of AK](#Specified-access-key-is-not-found)|
+| An invalid XML character (Unicode: 0x8) was found in the element content of the document |[Verify that the XML is valid](#xml-character)|
+| Server response has a bad format type    | [more](#Server-response-has-a-bad-format-type) |
+
+## Specified access key is not found
+
+Reasons and solutions:
+
+ 1. Ak doesn't have permission, contact the administrator to get permission
+ 2. Ak error, check the correctness of AK
+ 3. Environment mismatch, please confirm that AK is valid in the current environment
+ 
+## Server response has a bad format type
+
+Reasons and solutions:
+
+The response does not specify a data format
+
+1. `request.setAcceptFormat(FormatType.JSON)`. Add this code, if this cannot be fixed then you can use the second solution
+2. `HttpResponse response = client.doAction(request)` you could use this code to receive the returned data
+
+## xml character
+
+Reasons and solutions:
+
+[Official documentation](https://www.w3.org/TR/2000/REC-xml-20001006#NT-Char)
+
+The following three kinds of characters are illegal, please don't appear in XML
+
+ 1. 0x00 - 0x08
+ 2. 0x0b - 0x0c
+ 3. 0x0e - 0x1f
+
+***
+[← Log](8-Log-EN.md) | Exception[(中文)](9-Exception-CN.md) |[Home →](../README.md)
