背景

測試環(huán)境報錯，但很難排查到問題，可以像本地debug的方式來調(diào)試遠(yuǎn)程代碼

準(zhǔn)備

1. xshell + 遠(yuǎn)程服務(wù)

2. idea + 本地代碼

一、新增遠(yuǎn)程調(diào)試配置

1. idea -> run -> edit configration 

2.確定一個未被占用遠(yuǎn)程和本地占用的端口，開始編輯配置, 我這邊用的jdk8

復(fù)制出來的參數(shù)：

-agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=8205

二、服務(wù)添加遠(yuǎn)程調(diào)試參數(shù)

登錄服務(wù)器模塊，添加在第二步驟中復(fù)制的監(jiān)聽參數(shù)，然后重啟服務(wù),  手動啟動jar,  或者編輯啟動腳本，

手動啟動參數(shù)如下：

java -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=8205 -jar -Xmx512m -Xms512m web-4.2.jar

手動啟動結(jié)果如下：

調(diào)整啟動腳本示例如下：

手動啟動會提示：Listening for transport dt_socket at address: 8205

三、通過xshell將轉(zhuǎn)發(fā)端口8205透傳到本地

遠(yuǎn)程監(jiān)聽轉(zhuǎn)發(fā)接口為8205，本地監(jiān)聽配置端口為8205，所以透傳就是遠(yuǎn)程:8205 -> localhost:8205

四、開始遠(yuǎn)程調(diào)試

1.點擊idea 的遠(yuǎn)程配置Debug 按鈕，啟動遠(yuǎn)程調(diào)試web服務(wù)，成功啟動頁面如下：

2.對指定接口打上斷點，  點擊頁面，觸發(fā)接口，就會自動進入idea中斷點位置

TIPS：

問題1：idea添加配置后啟動debug按鈕無法點擊

排查遠(yuǎn)程服務(wù)是否啟動失敗， 排查監(jiān)聽端口是否透傳成功

問題2：啟動debug后等待一段時間彈出握手失敗報錯，然后停止監(jiān)聽

Error running '82-12001' Unable to open debugger port (localhost:8205): java.io.IOException "handshake failed - connection prematurally closed"

去排查xshell透出的端口，是否跟遠(yuǎn)程轉(zhuǎn)發(fā)端口一致。如上述步驟中所示：

web遠(yuǎn)程啟動端口為12001，轉(zhuǎn)發(fā)到8205端口， 此時我們需要將監(jiān)聽的8205端口傳到本地localhost,  這樣idea配置才能正常握手8025

問題3：調(diào)試斷點無法進入

遠(yuǎn)程代碼最好跟本地一致，以防出現(xiàn)斷點無法進入情況

知識點：

idea添加遠(yuǎn)程配置時生成的JVM參數(shù)是用于配置Java遠(yuǎn)程調(diào)試的核心參數(shù)，下面我詳細(xì)解釋每個部分的含義：

完整參數(shù)：

-agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=8205

分解解釋：

• -agentlib:jdwp

  • 表示加載JDWP（Java Debug Wire Protocol）代理庫

  • 這是Java調(diào)試的標(biāo)準(zhǔn)協(xié)議實現(xiàn)

• transport=dt_socket

  • 指定調(diào)試器與被調(diào)試JVM之間的通信傳輸方式

  • dt_socket表示使用socket網(wǎng)絡(luò)通信（最常用）

  • 替代選項：dt_shmem（共享內(nèi)存，僅限本地調(diào)試）

• server=y

  • 定義JVM作為調(diào)試服務(wù)端（等待調(diào)試器連接）

  • 如果設(shè)為n，則JVM會主動連接調(diào)試器（較少使用）

• suspend=n

  • 控制JVM啟動時是否暫停等待調(diào)試器連接

  • y：暫停，直到調(diào)試器連接（適合調(diào)試啟動過程）

  • n：立即啟動，調(diào)試器可以隨時連接（生產(chǎn)環(huán)境推薦）

• address=8205

  • 指定調(diào)試端口號（這里是8205）

  • JDK 9+需要格式：address=*:8205（允許任意IP連接）

  • 默認(rèn)只接受本地連接，如需遠(yuǎn)程需明確指定IP

總結(jié) 

到此這篇關(guān)于Java遠(yuǎn)程調(diào)試保姆級教程的文章就介紹到這了,更多相關(guān)Java遠(yuǎn)程調(diào)試內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評論