常見問(wèn)題
本文檔旨在幫助開發(fā)者快速接入和使用JAVA SDK，重點(diǎn)解答使用過(guò)程中遇到的常見問(wèn)題，確保開發(fā)者能夠準(zhǔn)確且高效地進(jìn)行相關(guān)操作。
環(huán)境檢查
確保Java語(yǔ)言環(huán)境已經(jīng)正確安裝，Java版本 >= 1.8。
確保您的網(wǎng)絡(luò)能夠訪問(wèn)阿里云的API。
問(wèn)題列表
問(wèn)題1：運(yùn)行時(shí)，提示“java.lang.NullPointerException: Cannot invoke "java.util.Map...”..."。
問(wèn)題3：運(yùn)行時(shí)，提示“java: Compilation failed: internal java compiler error”。
問(wèn)題4：運(yùn)行時(shí)，提示“code: 400, is mandatory for this action... ...”
問(wèn)題7：運(yùn)行時(shí)，提示“Your request is denied as lack of ssl protect.RequestId ...”。
問(wèn)題8：運(yùn)行時(shí)，提示“code: 404, Specified api is not found, please check your url and method.”。
問(wèn)題9：運(yùn)行時(shí)，提示“Unexpected response code for CONNECT: 400”。
問(wèn)題11：運(yùn)行時(shí)提示“Can not set java.lang.String field com.aliyun.imm20200930...”。
問(wèn)題1：運(yùn)行時(shí)，提示“java.lang.NullPointerException: Cannot invoke "java.util.Map.get(Object)" because the return value of "com.aliyun.tea.TeaException.getData()" is null at ...”。
可能是因?yàn)槟鷽](méi)有正確地設(shè)置阿里云的訪問(wèn)密鑰（AccessKey）。
錯(cuò)誤示例：
Config config = new Config()
// 必填，請(qǐng)確保代碼運(yùn)行環(huán)境設(shè)置了環(huán)境變量 ALIBABA_CLOUD_ACCESS_KEY_ID。
.setAccessKeyId(System.getenv("LTAI5tA******"))
// 必填，請(qǐng)確保代碼運(yùn)行環(huán)境設(shè)置了環(huán)境變量 ALIBABA_CLOUD_ACCESS_KEY_SECRET。
.setAccessKeySecret(System.getenv("0wpTxkN******"));正確示例：
Config config = new Config()
// 必填，請(qǐng)確保代碼運(yùn)行環(huán)境設(shè)置了環(huán)境變量 ALIBABA_CLOUD_ACCESS_KEY_ID。
.setAccessKeyId(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID"))
// 必填，請(qǐng)確保代碼運(yùn)行環(huán)境設(shè)置了環(huán)境變量 ALIBABA_CLOUD_ACCESS_KEY_SECRET。
.setAccessKeySecret(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET"));建議做法：
切勿直接在代碼中明文寫入 AccessKey 的值。該寫法存在安全隱患。
System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID")和System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET")，表示是從環(huán)境變量中獲取ALIBABA_CLOUD_ACCESS_KEY_ID及ALIBABA_CLOUD_ACCESS_KEY_SECRET的值。
檢查您的環(huán)境變量中是否配置有ALIBABA_CLOUD_ACCESS_KEY_ID和ALIBABA_CLOUD_ACCESS_KEY_SECRET。
在終端（Linux/macOS）或單擊開始（或快捷鍵：Win+R）>運(yùn)行（輸入 cmd）>確定（或按 Enter 鍵），打開命令提示符（Windows），執(zhí)行以下命令。若返回正確的AccessKey，則說(shuō)明配置成功。如果返回為空或錯(cuò)誤，請(qǐng)嘗試重新設(shè)置，具體操作請(qǐng)參見設(shè)置訪問(wèn)憑據(jù)。
Windows
echo %ALIBABA_CLOUD_ACCESS_KEY_ID%
echo %ALIBABA_CLOUD_ACCESS_KEY_SECRET%Linux/macOS
echo $ALIBABA_CLOUD_ACCESS_KEY_ID
echo $ALIBABA_CLOUD_ACCESS_KEY_SECRET問(wèn)題2：運(yùn)行時(shí)，提示“java: 錯(cuò)誤：不支持發(fā)行版本 X”。
同時(shí)按下Ctrl+Alt+Shift+S，進(jìn)入Project Structure窗口。選擇Modules，在右側(cè)Language Level中選擇跟您所使用JDK版本一致的版本，例如您所使用的JDK 8，Language Level選擇“8 - Lambdas, type annotations etc. ”。單擊Apply，單擊OK。
問(wèn)題3：運(yùn)行時(shí)，提示“java: Compilation failed: internal java compiler error”。
在IntelliJ IDEA菜單欄，單擊File->Settings->Build, Execution, Deployment->Compiler->Java Compiler，Project bytecode version和Target bytecode version選擇跟您所使用JDK版本一致的版本，例如您所使用的JDK 8，這兩項(xiàng)選擇 8 即可。單擊Apply，單擊OK。
問(wèn)題4：運(yùn)行時(shí)，提示“code: 400, <CERTAIN_FIELD > is mandatory for this action... ...”
此問(wèn)題的直接原因在于在調(diào)用API時(shí)未填寫必填參數(shù)。解決方案：
這里以調(diào)用短信服務(wù)的SendSms接口為例：
進(jìn)入OpenAPI門戶的API調(diào)試頁(yè)面，選擇云產(chǎn)品和接口。
仔細(xì)對(duì)比構(gòu)造的請(qǐng)求對(duì)象（如
SendSmsRequest）是否填充了所有必需字段，例如手機(jī)號(hào)、簽名等。參考API文檔確認(rèn)必填項(xiàng)。確保必填參數(shù)值正確。
確保填寫的必填參數(shù)值正確無(wú)誤，例如手機(jī)號(hào)格式是否符合要求。
在調(diào)用 API 前，SDK 會(huì)對(duì)參數(shù)進(jìn)行自動(dòng)校驗(yàn)。如果缺少必要參數(shù)，您將收到類似
MissingRequiredParameter的錯(cuò)誤提示。例如，如果手機(jī)號(hào)參數(shù)缺失，會(huì)報(bào)錯(cuò) “MissingPhoneNumbers: code: 400”。
SendSmsRequest sendSmsRequest = new SendSmsRequest()
//需要替換成為您接收短信的手機(jī)號(hào)碼
.setPhoneNumbers("<YOUR_VALUE>")
//需要替換成為您的短信簽名
.setSignName("<YOUR_VALUE>")
//需要替換成為您的短信模板code
.setTemplateCode("<YOUR_VALUE>");問(wèn)題5：運(yùn)行時(shí)，提示“java.lang.NoSuchMethodError”。
NoSuchMethodError異常多由依賴包版本沖突造成，主要因?yàn)樵诰幾g與運(yùn)行時(shí)使用了不同版本的依賴包，類加載器在編譯時(shí)檢索到未定義方法/字段/類。解決方案：
若是直接使用jar的用戶，可能是某些子級(jí)jar未依賴。根據(jù)堆棧排查缺失的jar包即可。
若是使用maven/gradle等包管理器用戶，可能是子級(jí)依賴沖突導(dǎo)致項(xiàng)目編譯時(shí)使用的是低版本的包導(dǎo)致。可根據(jù)堆棧排查沖突的依賴并指定高版本即可。
問(wèn)題6：調(diào)用API超時(shí)，提示“java.net.SocketTimeoutException：connect timed out“或”java.net.SocketTimeoutException：Read timed out”。
超時(shí)問(wèn)題可能由多種因素引起，以下是一些常見的原因及相應(yīng)的解決步驟：
網(wǎng)絡(luò)連接問(wèn)題
情況描述：客戶端與服務(wù)器之間的網(wǎng)絡(luò)不通或網(wǎng)絡(luò)不穩(wěn)定導(dǎo)致請(qǐng)求無(wú)法到達(dá)目標(biāo)服務(wù)器。
解決方案：
使用命令
ping [www.example.com/192.168.x.x]或curl -Is https://xxx.xxx.xx檢查網(wǎng)絡(luò)連通性。當(dāng)遇到網(wǎng)絡(luò)不通時(shí)，應(yīng)在防火墻或路由器中檢查是否有阻斷策略；對(duì)于網(wǎng)絡(luò)不穩(wěn)定的情況，建議更換網(wǎng)絡(luò)環(huán)境。通過(guò)配置延長(zhǎng)超時(shí)時(shí)間， 具體操作請(qǐng)參見超時(shí)機(jī)制。例如通過(guò)配置連接超時(shí)參數(shù)來(lái)延長(zhǎng)連接超時(shí)時(shí)間，示例代碼如下：
// 運(yùn)行時(shí)參數(shù)超時(shí)設(shè)置，僅對(duì)使用了該運(yùn)行時(shí)參數(shù)實(shí)例的請(qǐng)求有效
RuntimeOptions runtimeOptions = new RuntimeOptions();
runtimeOptions.connectTimeout = 5000;API處理時(shí)間過(guò)長(zhǎng)
情況描述：目標(biāo)API處理請(qǐng)求的時(shí)間超過(guò)了設(shè)置的讀超時(shí)時(shí)間。
解決方案：通過(guò)配置讀超時(shí)時(shí)間來(lái)適應(yīng)較長(zhǎng)的API響應(yīng)時(shí)間， 具體操作請(qǐng)參見超時(shí)機(jī)制。例如通過(guò)配置讀超時(shí)時(shí)間參數(shù)來(lái)延長(zhǎng)當(dāng)前請(qǐng)求的讀超時(shí)時(shí)間，示例代碼如下：
// 運(yùn)行時(shí)參數(shù)超時(shí)設(shè)置，僅對(duì)使用了該運(yùn)行時(shí)參數(shù)實(shí)例的請(qǐng)求有效
RuntimeOptions runtimeOptions = new RuntimeOptions();
runtimeOptions.readTimeout = 10000;問(wèn)題7：運(yùn)行時(shí)，提示“Your request is denied as lack of ssl protect.RequestId ...”。
此問(wèn)題是由于接口要求使用HTTPS協(xié)議進(jìn)行調(diào)用，而您可能使用了原版JavaSDK，采用了HTTP協(xié)議進(jìn)行調(diào)用。解決方案：
V1.0 SDK 可以通過(guò)對(duì) Request 對(duì)象設(shè)置請(qǐng)求通過(guò) HTTPS 協(xié)議發(fā)送：
request.setSysProtocol(com.aliyuncs.http.ProtocolType.HTTPS);使用V2.0SDK，V2.0SDK默認(rèn)使用HTTPS協(xié)議。
問(wèn)題8：運(yùn)行時(shí)，提示“code: 404, Specified api is not found, please check your url and method.”。
此類錯(cuò)誤的直接原因可能是您在調(diào)用某產(chǎn)品API時(shí)，填寫了錯(cuò)誤的Endpoint或RegionId。解決方法如下：
確保您所選區(qū)域支持您正在調(diào)用的服務(wù)。產(chǎn)品的Endpoint可以通過(guò)OpenAPI 開發(fā)者門戶的產(chǎn)品主頁(yè)中進(jìn)行查找，這里以短信服務(wù)為例。
問(wèn)題9：運(yùn)行時(shí)，提示“Unexpected response code for CONNECT: 400”。
此問(wèn)題直接原因?yàn)檎?qǐng)求未發(fā)送到阿里云網(wǎng)關(guān)，被中間節(jié)點(diǎn)截?cái)唷＝鉀Q方案：
可能是代理配置錯(cuò)誤，例如您配置的是setHttpProxy，V2.0 SDK默認(rèn)發(fā)送HTTPS請(qǐng)求，即代理不生效會(huì)引發(fā)此報(bào)錯(cuò)。可通過(guò)配置協(xié)議類型為HTTP嘗試解決，config.protocol = "HTTP"。
可能代理服務(wù)配置錯(cuò)誤，即代理服務(wù)無(wú)法正確轉(zhuǎn)發(fā)請(qǐng)求到阿里云網(wǎng)關(guān)，可通過(guò)curl檢查代理配置是否正確。curl https://<阿里云服務(wù)域名>/ -v -x <代理IP/代理域名>:<代理端口>，例如curl https://ecs-cn-hangzhou.aliyuncs.com/ -v -x 127.0.0.1:3128。
可能被內(nèi)網(wǎng)防火墻攔截，本地環(huán)境可嘗試切換網(wǎng)絡(luò)環(huán)境測(cè)試，例如連接移動(dòng)網(wǎng)絡(luò)熱點(diǎn)。
問(wèn)題10：運(yùn)行時(shí)，提示“Specified signature does not match our calculation. server StringToSign is ...”。
此問(wèn)題直接原因?yàn)榭蛻舳撕灻麉?shù)和服務(wù)端計(jì)算得到簽名參數(shù)不匹配導(dǎo)致報(bào)錯(cuò)。解決方案：
在絕大多數(shù)場(chǎng)景中，用戶SK填寫信息存在錯(cuò)誤，因此應(yīng)首先重新生成一版新的AK，然后再進(jìn)行后續(xù)的排查。
升級(jí)SDK子級(jí)依賴openapiutil到最新版本。
通過(guò)抓取請(qǐng)求包，檢查網(wǎng)絡(luò)層面是否遭遇字段攔截。
代碼調(diào)試，檢查客戶端是否存在特殊字符導(dǎo)致的轉(zhuǎn)碼異常。
檢查以下依賴包版本是否過(guò)低。
<dependency> <groupId>commons-codec</groupId> <artifactId>commons-codec</artifactId> <version>1.15</version> </dependency>檢查是否在并發(fā)場(chǎng)景重新new request，request并不線程安全。
問(wèn)題11：運(yùn)行時(shí)，提示“Can not set java.lang.String field com.aliyun.imm20200930.models.GenerateWebofficeTokenShrinkRequest.userShrink to java.util ...”。
此問(wèn)題直接原因?yàn)榈桶姹?span data-tag="ph" id="75351e01d17x8" class="ph">Tea包無(wú)法將復(fù)雜結(jié)構(gòu)轉(zhuǎn)化為String結(jié)構(gòu)導(dǎo)致報(bào)錯(cuò)。解決方案：
升級(jí)Tea包到1.2.7及以上。
<dependency>
<groupId>com.aliyun</groupId>
<artifactId>tea</artifactId>
<version>1.2.7</version>
</dependency>問(wèn)題12：IDEA中使用Maven自動(dòng)下載依賴失敗。
更新Maven倉(cāng)庫(kù)
打開”File“菜單，選擇”Settings“（或”Preferences“）。左側(cè)導(dǎo)航欄中，展開“Build, Execution, Deployment”，然后選擇“Build Tools” > “Maven”。找到“Repositories”選項(xiàng)卡，選擇本地倉(cāng)庫(kù)，點(diǎn)擊“Update”按鈕，等待更新完成。
檢查IDEA緩存
打開“File”菜單，選擇“Invalidate Caches…”，在彈出的對(duì)話框中，選擇“Invalidate and Restart”，等待IDEA清理緩存并重新啟動(dòng)。
檢查網(wǎng)絡(luò)鏈接
如果Maven無(wú)法連接到中央倉(cāng)庫(kù)或其他遠(yuǎn)程倉(cāng)庫(kù)，它可能會(huì)無(wú)法下載依賴項(xiàng)。確保您的網(wǎng)絡(luò)連接正常，并且沒(méi)有任何防火墻或代理服務(wù)器阻止Maven的訪問(wèn)。
檢查Maven配置
檢查Maven配置文件（通常是settings.xml）是否正確配置。確保”localRepository“指向正確的本地倉(cāng)庫(kù)路徑，”mirrors”、”proxies“、”profiles“正確配置。
Java語(yǔ)言基礎(chǔ)異常自查表
報(bào)錯(cuò)信息 | 錯(cuò)誤原因 | 解決方案 |
NullPointerException | 嘗試在一個(gè)空對(duì)象上調(diào)用方法或訪問(wèn)屬性。 | 在使用對(duì)象之前，先進(jìn)行空對(duì)象判斷（null check）以避免空指針異常。可以使用條件語(yǔ)句或斷言來(lái)進(jìn)行判斷。 |
ArrayIndexOutOfBoundsException | 嘗試訪問(wèn)數(shù)組中不存在的索引。 | 確保數(shù)組索引在有效范圍內(nèi)，即大于等于0且小于數(shù)組長(zhǎng)度。可以使用循環(huán)結(jié)構(gòu)或條件語(yǔ)句來(lái)避免數(shù)組越界異常。 |
IllegalArgumentException | 方法接收到一個(gè)不合法的參數(shù)。 | 檢查傳遞給方法的參數(shù)，確保其滿足方法的要求。可以使用條件語(yǔ)句或斷言進(jìn)行參數(shù)合法性檢查。 |
ArithmeticException | 在算術(shù)運(yùn)算中發(fā)生了異常，例如除以0。 | 在進(jìn)行算術(shù)運(yùn)算之前，先進(jìn)行必要的判斷和處理，確保不會(huì)出現(xiàn)異常情況。可以使用條件語(yǔ)句或異常處理機(jī)制來(lái)處理算術(shù)異常。 |
ClassCastException | 嘗試將一個(gè)對(duì)象轉(zhuǎn)換為不兼容的類型。 | 在進(jìn)行類型轉(zhuǎn)換之前，先使用 instanceof 運(yùn)算符進(jìn)行類型檢查，確保對(duì)象的類型是兼容的。如果類型不兼容，可以考慮使用合適的類型轉(zhuǎn)換或者重新設(shè)計(jì)對(duì)象的繼承關(guān)系。 |
FileNotFoundException | 嘗試打開一個(gè)不存在的文件。 | 確保文件路徑和文件名正確，并且文件存在于指定的位置。可以使用條件語(yǔ)句或異常處理機(jī)制來(lái)處理文件未找到異常。 |
IOException | 在進(jìn)行輸入輸出操作時(shí)發(fā)生了異常，如讀寫文件、網(wǎng)絡(luò)通信等。 | 檢查輸入輸出操作的正確性，確保文件或資源可用，并處理可能的異常情況。可以使用異常處理機(jī)制來(lái)處理輸入輸出異常。 |
InterruptedException | 在進(jìn)行多線程操作時(shí)，線程被意外中斷。 | 在處理多線程操作時(shí)，對(duì)線程中斷進(jìn)行適當(dāng)?shù)奶幚怼？梢允褂卯惓Ｌ幚頇C(jī)制或條件判斷來(lái)處理線程中斷異常。 |
NoSuchMethodException | 嘗試調(diào)用一個(gè)不存在的方法。 | 檢查方法名和參數(shù)是否正確，并確保調(diào)用的方法存在。可以使用條件語(yǔ)句或異常處理機(jī)制來(lái)處理方法不存在異常。 |
NumberFormatException | 將一個(gè)無(wú)法轉(zhuǎn)換為數(shù)字的字符串轉(zhuǎn)換為數(shù)字。 | 在進(jìn)行字符串轉(zhuǎn)換為數(shù)字的操作時(shí)，先進(jìn)行合理的校驗(yàn)，確保字符串能夠正確轉(zhuǎn)換為數(shù)字。可以使用條件語(yǔ)句或異常處理機(jī)制來(lái)處理數(shù)字格式異常。 |
IndexOutOfBoundsException | 嘗試訪問(wèn)列表或字符串中不存在的索引。 | 確保索引在有效范圍內(nèi)，即大于等于0且小于列表或字符串的長(zhǎng)度。可以使用條件語(yǔ)句或異常處理機(jī)制來(lái)處理索引越界異常。 |
UnsupportedOperationException | 嘗試調(diào)用一個(gè)不支持的方法或操作。 | 查閱文檔或API文檔，了解支持的方法和操作。確保方法或操作在當(dāng)前環(huán)境下是可行的。 |
IllegalMonitorStateException | 在不合適的時(shí)候調(diào)用 wait()、notify() 或 notifyAll() 方法。 | 確保在同步代碼塊中正確使用 wait()、notify() 或 notifyAll() 方法。可以使用條件語(yǔ)句或異常處理機(jī)制來(lái)處理非法的監(jiān)視器狀態(tài)異常。 |
SecurityException | 嘗試執(zhí)行違反安全規(guī)則的操作，如未授權(quán)的訪問(wèn)、文件權(quán)限等。 | 檢查代碼中的安全規(guī)則，確保不違反安全規(guī)則。可以根據(jù)安全規(guī)則進(jìn)行相應(yīng)的調(diào)整和修改。 |
ClassNotFoundException | 嘗試加載一個(gè)不存在的類。 | 在SDK中一般是依賴沖突，即低版本依賴搶占了索引，導(dǎo)致V2.0 SDK的類不存在。檢查類名和類路徑是否正確，并確保所需的類存在。可以使用條件語(yǔ)句或異常處理機(jī)制來(lái)處理類未找到異常。 |
NoSuchFieldException | 嘗試訪問(wèn)一個(gè)不存在的字段。 | 在SDK中一般是依賴沖突，即低版本依賴搶占了索引，導(dǎo)致V2.0 SDK的方法不存在。確保字段名正確，并確保訪問(wèn)的字段存在。可以使用條件語(yǔ)句或異常處理機(jī)制來(lái)處理字段不存在異常。 |
技術(shù)支持
以上問(wèn)題的解決方案旨在幫助您更友好地使用阿里云SDK。如果您在使用過(guò)程中遇到其他問(wèn)題，請(qǐng)通過(guò)以下方式與我們聯(lián)系：
提交工單：阿里云提交工單頁(yè)面。
如果您有相關(guān)需求或反饋，可以添加釘釘群聯(lián)系阿里云技術(shù)支持人員，群號(hào)為60965016010。