渗透与代码审计
渗透最重要的是思路和经验
# 渗透测试基础
ICSL 考试
# 规范与方法论
| 方向 \ 内容 | |
|---|---|
| Java & Web | 1. Spring Boot 2. Java 三大器:Listener、Filter、Intercepter 3. Java 安全模型 4. Java 类加载机制 5. Java 多线程 6. Java 网络编程 7. IOC、DI 和 AOP 8. Java 反射机制 |
| 数据库 DB | 1. MySQL 2. ORM 3. Redis 4. MongoDB |
| 脚本语言 Script | 1. Python HTTP 2. Python Socket 3. Python Burpsuite 插件开发 4. Python 本地碰撞密码 |
| 后端安全 Web Back Security | 1. 身份认证和权限控制 2. SQL 注入 3. 代码注入 4. OS 命令注入 5. XML 注入 6. SSRF 漏洞 7. Java 反序列化漏洞 |
| 前端安全 Web Front Security | 1. XSS 反射漏洞 |
| 框架安全 Web Framework Security | 1. Apache 2. Nginx 3. Tomcat 4. Jetty 5. Flask 6. Beego 7. BME |
五大设计规范
- 会话管理安全设计规范
- 密码算法应用规范
- 密码管理安全规范
- 身份与访问管理安全规范
- 隐私保护设计规范
白盒验证测试方法(验证测试部)一般的审计流程
- 工具扫危险点,通常是一些危险函数和危险语句
- 分析入参传递,是否能从上层达到危险点并执行
- 依次排除
方法论
- 收集产品信息
- 制定测试策略
- 掌握测试方法
- 输出测试报告
合规类问题验证
- 敏感信息泄露
- 密码算法合规
- 不安全协议和加密套件
- 源码无公网地址
典型漏洞验证
- SQL 注入
- 远程命令执行
- XML 注入
- XSS 漏洞
- 文件上传 / 下载
业务逻辑类问题验证
- 权限控制
- 绕过安全过滤
- 条件竞争
一些调试习惯
- 断点调试
- 打断点跑项目或许是读懂源码的最快方式
- 打断点 → debug 运行 → 打断点 → 查看变量值 / 计算表达式值 → 断点步入 → 下一跳 → 下一断点 → 忽略断点
- IDEA 快捷键
- Ctrl + Alt + 左右方向键:找到上/下一个高亮
- Alt + F8:计算表达式值
- Ctrl + Alt + H:查看完整调用链
- 准星设置:“始终选择打开的文件”
重点是关注漏洞的传递,即污点是否能够抵达危险函数,危险函数并不可怕,只需要加上防御机制就并非漏洞
# 常见漏洞
whgojp/JavaSecLab: JavaSecLab is a comprehensive Java vulnerability platform (opens new window)
SQL 注入:攻击者在 Web 应用的输入字段中插入恶意 SQL 语句,使得服务器执行非预期的数据库操作,造成
- 数据泄露(如用户名密码)
- 数据篡改或删除
- 登录绕过
- 提权(如使用
xp_cmdshell)
输入用户名: ' OR '1'='1
文件操纵:利用用户对文件路径或内容的输入控制,执行非法文件操作,如读取任意文件、覆盖系统文件等
- 任意文件读取(LFI / Path Traversal)
- 任意文件上传
- 文件包含(RFI / LFI)
例如
- 读取敏感文件(如
/etc/passwd) - 上传 Webshell,远程控制服务器
GET /?file=../../../../etc/passwd
SSRF 服务器端请求伪造:攻击者诱导服务器向内网或其他受保护资源发起请求,实现信息收集或攻击内网
- 扫描内网服务
- 获取内网接口数据
- 利用云服务元数据获取访问凭证(如 AWS)
示例
http://localhost:8080/fetch?url=http://169.254.169.254/latest/meta-data/
命令注入:Web 应用中拼接了用户输入到系统命令中,攻击者可以注入并执行恶意命令
- 远程执行任意系统命令
- 上传、删除、修改文件
- 建立反弹 shell
XML 注入:包括 XXE,攻击者构造恶意 XML 数据,通过外部实体注入(XXE)实现文件读取、请求伪造等
- 任意文件读取
- SSRF
- 拒绝服务(DoS)
- 泄露内存信息
<!DOCTYPE foo [
<!ELEMENT foo ANY >
<!ENTITY xxe SYSTEM "file:///etc/passwd" >
]>
<foo>&xxe;</foo>
2
3
4
5
本地提权(Local Privilege Escalation):攻击者在系统中已经获得低权限账户,通过利用系统漏洞、配置错误等方式,提升至管理员权限
- 利用 SUID 程序漏洞
- 滥用计划任务(cron)
- 漏洞内核(如 Dirty COW)
例如
- 获得 root 权限
- 控制整个主机
- 持久化攻击入口
# 靶场渗透基础
练手靶场
常见工具
- Kali Linux
- Windows:UTools、Listary、BurpSuite
# Micro-CMS v1
CMS(Content Management System):网站内容管理系统
通过 js 脚本直接注入 html,这是最简单常用的 POC(Proof of Concept,漏洞验证)
<script>alert(\xss)</script>
通过 img 标签的错误事件(随便请求一张图片)注入js事件
<img src=x onerror=alert(xss)>
# Training: Get Sourced
F12查看HTML源码,答案写在注释里,藏在body的右下方
<!-- Now this is a comment! -->
<!-- You are looking for this password: html_sourcecode -->
</body></html>
2
3
# Training: Stegano Ⅰ
通过html代码找到图片源下载,得到btegano1.bmp,直接用记事本或者notepad++打开,或修改后缀为.txt打开,可得到答案
BMf 6 ( 0 Look what the hex-edit revealed: passwd:steganoI
可以用notepad++等编辑器打开bmp文件,在末尾加入文字信息(若用记事本直接修改将损坏文件)
# Training: MySQL Ⅰ
查看后端源码发现登录的SQL语句是这么写的,同时发现了管理员用户名admin
$query = "SELECT * FROM users WHERE username='$username' AND password='$password'";
可以在传入用户名时动手脚
1、传入admin'#,这样sql语句的字符串将变成
"select * from users where username='admin''#..."
于是验证密码的部分被替换为sql注释,因为admin存在,返回一定为真
2、传入admin' or '1
select * from users where username='admin' or '1' and password='$password'
同样因为掺入了1,于是返回始终为真
# Training: Crypto-Caesar Ⅰ
简单的古典密码解密,给定一串码
PDA MQEYG XNKSJ BKT FQILO KRAN PDA HWVU ZKC KB YWAOWN WJZ UKQN QJEMQA OKHQPEKJ EO BWCYZILHHNKW
合理猜测每个字母加上一个相同的数变为当前码,如A+2=C, Z+1=A
于是编写程序列出总共26种可能性,同时将大写转小写便于阅读
python 代码
code = "LZW IMAUC TJGOF XGP BMEHK GNWJ LZW DSRQ VGY GX USWKSJ SFV QGMJ MFAIMW KGDMLAGF AK YZJJKAKWUUKH"
i = 0
while i < 26:
print(i+1, end='.')
for c in code:
if c == ' ':
print(c, end='')
continue
print(chr(97+(ord(c)-65+i)%26),end="")
i += 1
print('\n')
2
3
4
5
6
7
8
9
10
11
从 26 句中找到有意义的一行
the quick brown fox jumps over the lazy dog of caesar and your unique solution is ghrrsiseccsp
密码为
ghrrsiseccsp
# Encodings: URL
给定一串URL码
%59%69%70%70%65%68%21%20%59%6F%75%72%20%55%52%4C%20%69%73%20%63%68%61%6C%6C%65%6E%67%65%2F%74%72%61%69%6E%69%6E%67%2F%65%6E%63%6F%64%69%6E%67%73%2F%75%72%6C%2F%73%61%77%5F%6C%6F%74%69%6F%6E%2E%70%68%70%3F%70%3D%64%64%6F%65%70%61%6C%68%65%61%73%68%26%63%69%64%3D%35%32%23%70%61%73%73%77%6F%72%64%3D%66%69%62%72%65%5F%6F%70%74%69%63%73%20%56%65%72%79%20%77%65%6C%6C%20%64%6F%6E%65%21
URL实际上就是16进制的ASCII码,每个字符通过%分隔开
直接在控制台用js当然也是可以的,调用decodeURL()函数
url = '%59%69%70%70%65%68%21%20%59%6F%75%72%20%55%52%4C%20%69%73%20%63%68%61%6C%6C%65%6E%67%65%2F%74%72%61%69%6E%69%6E%67%2F%65%6E%63%6F%64%69%6E%67%73%2F%75%72%6C%2F%73%61%77%5F%6C%6F%74%69%6F%6E%2E%70%68%70%3F%70%3D%64%64%6F%65%70%61%6C%68%65%61%73%68%26%63%69%64%3D%35%32%23%70%61%73%73%77%6F%72%64%3D%66%69%62%72%65%5F%6F%70%74%69%63%73%20%56%65%72%79%20%77%65%6C%6C%20%64%6F%6E%65%21'
'%59%69%70%70%65%68%21%20%59%6F%75%72%20%55%52%4C%20%69%73%20%63%68%61%6C%6C%65%6E%67%65%2F%74%72%61%69%6E%69%6E%67%2F%65%6E%63%6F%64%69%6E%67%73%2F%75%72%6C%2F%73%61%77%5F%6C%6F%74%69%6F%6E%2E%70%68%70%3F%70%3D%64%64%6F%65%70%61%6C%68%65%61%73%68%26%63%69%64%3D%35%32%23%70%61%73%73%77%6F%72%64%3D%66%69%62%72%65%5F%6F%70%74%69%63%73%20%56%65%72%79%20%77%65%6C%6C%20%64%6F%6E%65%21'
answer = decodeURI(url)
'Yippeh! Your URL is challenge%2Ftraining%2Fencodings%2Furl%2Fsaw_lotion.php%3Fp%3Dddoepalheash%26cid%3D52%23password%3Dfibre_optics Very well done!'
2
3
4
# Training: ASCII
给定一串ASCII码
84, 104, 101, 32, 115, 111, 108, 117, 116, 105, 111, 110, 32, 105, 115, 58, 32, 98, 109, 97, 108, 114, 110, 114, 97, 103, 103, 115, 114
js 解码
ascii = [84, 104, 101, 32, 115, 111, 108, 117, 116, 105, 111, 110, 32, 105, 115, 58, 32, 98, 109, 97, 108, 114, 110, 114, 97, 103, 103, 115, 114]
res = ""
for(let i in ascii){
res += String.fromCodePoint(ascii[i])
}
console.log(res);
2
3
4
5
6
得到
The solution is:bmalrnraggsr
故密码为
bmalrnraggsr
# BurpSuite 抓包重放
通过 BurpSuite 对网络请求进行抓包
Burp Suite Professional 是一套来自 PortSwigger,用于测试 web 安全性的高级工具集,从一个基本的拦截代理到尖端的 Burp 扫描器
- Burp Suite Professional 2025.12 for Windows x64 - 领先的 Web 渗透测试软件 (opens new window)
- Download Burp Suite Community Edition - PortSwigger (opens new window)
入门:BurpSuite 安装及使用实操 - 刑之风 - 博客园 (opens new window)
BurpSuite 测试流程
- 设置端口代理
- 抓包
- 重放
基本思路:在 Burp 设置 Proxy 拦截,然后把浏览器/程序/应用写一个代理发到 Burp 的 Proxy 上,Burp 将作为一个中转站进行网络通信,这样就能对每个 HTTP 进行数据抓包
首先在 Burp 的 Settings → Tools → Proxy 中设置代理127.0.0.1:8080
若是 Spring 程序,可以在启动类前设置代理
public static void setProxy(){
System.setProperty("http.proxyHost", "127.0.0.1");
System.setProperty("http.proxyPort", "8080");
System.setProperty("https.proxyHost", "127.0.0.1");
System.setProperty("https.proxyPort", "8080");
}
public static void main(String[] args){
ProxyUtil.setProxy();
SpringApplication.run(AuditAiAgentApplication.class, args);
}
2
3
4
5
6
7
8
9
10
11
这样从 Spring 打出的所有网络请求都会走127.0.0.1:8080,从而被 Burp 捕捉
其他代理设置
- 在浏览器中,通过 Zero Omega 同样可以设置这样的代理:选项 → 情景模式 → 新建情景模式(设置为
127.0.0.1:8080)同默,而后启用即可,这样 Burp 就能捕捉到当前浏览器发出的所有 HTTP 请求 - 本地应用代理设置:Proxifier
一些使用小技巧
- Ctrl + R 重放请求 Repeater
- Intercept on 打开网络断电
- HTTP history 查看每一次请求包
# 脚本与协议
脚本语言,如 PHP、Bash、Lua 等等
# PHP 基础
PHP(Hypertext Preprocessor),超文本预处理器,原名 Personal Home Page,养活中文互联网 10 年渗透,内核为 C
- PHP 文件可包含文本、HTML、JavaScript 代码和 PHP 代码
- PHP 代码在服务器上执行,结果以纯 HTML 形式返回给浏览器
LAMP(Linux + Apache + MySQL + PHP)环境:WampServer (opens new window)
下载完成后,启动 wampmanager.exe,这将启动一系列服务
- PHP 编译执行环境
- MySQL:跑在 3306 端口
- Apache 服务器:通过
localhost/index.php将可以访问到 wamp 根目录 www 目录下的动态 html 文件
一个简单的 PHP 示例,简单来说,就是在 HTML 页面里面嵌入 PHP 代码
test_mysql.php
<?php
echo '<h1><center>NMSL<center></h1>';
$user = 'root';
$password = '';
$database = '';
$port = NULL;
$mysqli = new mysqli('127.0.0.1', $user, $password, $database, $port);
if ($mysqli->connect_error) {
die('Connect Error (' . $mysqli->connect_errno . ') '
. $mysqli->connect_error);
}
echo '<p>Connection OK '. $mysqli->host_info.'</p>';
echo '<p>Server '.$mysqli->server_info.'</p>';
echo '<p>Initial charset: '.$mysqli->character_set_name().'</p>';
$mysqli->close();
?>
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
PHP Web Shell:一个简单的 PHP WebShell,一般来说,将 webshell 上传至服务器并具有执行权限的 WEB 目录下,就能实现远程访问 webshell 控制服务器的目的
# 常用 Linux 命令
查进程:ps + grep
ps -ef | grep function
kill -0 pid
2
查日志:cat + grep
cat service.log.* | grep '313126566710330' | grep 'makepptoutline'
pdo2 -bns group.gdp-ghome-online.pandora.all -y -q -r 5 -show row " cat /home/work/odp/log/service/service.log.wf | grep '2947948859' " | grep -v "need jump" | grep -v "sshMatrix"
pdo2 -bns group.gdp-ghome-online.pandora.all -y -q -r 5 -show row " cat /home/work/odp/log/service/service.log | grep '1809944544' " | grep -v "need jump" | grep -v "sshMatrix"
pdo2 -bns group.gdp-ghome-online.pandora.all -y -q -r 5 -show row " cat /home/work/odp/log/access_log | grep '1809944544' " | grep -v "need jump" | grep -v "sshMatrix"
2
3
4
5
6
7
查进程(没有 ps 的情况下):top
top
- 默认 3 秒刷新一次。
- 按内存排序:按
M键 (大写),内存占用最高的进程会排到最上面 - 退出:
q键 - 核心字段:
RES常驻物理内存,真正占用的物理内存大小 (单位 KB);%MEM为 RES 占总物理内存的百分比;VIRT虚拟内存总量
如何定位 OOM?OOM 是内核行为,日志会记录在内核缓冲区或系统日志中,所以核心思路是
- 使用
top命令进行实时监控 cat grep读取/proc日志文件dmesg查看内核日志
通过内核查看进程信息:所有进程信息都在 /proc/[PID] 目录下
# 列出所有进程 PID (替代 ps -ef)
ls /proc | grep -E '^[0-9]+$'
# 查看进程详细状态 (包含内存)
cat /proc/1234/status
# 过滤出关键内存指标
cat /proc/1234/status | grep -E "^VmRSS|^VmSize|^VmData"
2
3
4
5
6
7
8
VmRSS: 物理内存占用 (KB),对应 top 的 RESVmSize: 虚拟内存总大小 (KB),对应 top 的 VIRT
查看 OOM 日志
# 过滤 OOM 相关日志
dmesg | grep -i "out of memory\|killed process"
# 显示更友好的时间格式 (-T),并查看上下文 (-B 前5行, -A 后30行)
dmesg -T | grep -A 30 -B 5 "Out of memory"
# 查看 OOM 计数
cat /proc/meminfo | grep OomKillCount
2
3
4
5
6
7
8
# HTTPS 与 TLS 协议
HTTPS = HTTP + SSL / TLS
众所周知,HTTP 是建立在 TCP 基础上的应用层协议,TPC 通过三次握手在服务端和客户端之间建立长连接(在 HTTP1.0 之后),通过超时重传、确认帧来保证可靠传输
而三次握手并不存在身份认证,他仅靠累加的 ACK 码来确认握手双方的回应,这会造成
- 客户端无法认证服务端身份,任意一个服务器可以伪造响应来欺骗客户端,例如,攻击者可以搭建一个伪造网站(如模仿银行官网),并让用户的 HTTP 请求指向该伪造站点获取用户敏感信息
- HTTP 没有机制确认传输的数据是否完整,攻击者可在传输过程中随意修改数据包内容,接收方无法察觉数据已被篡改,无法抵抗中间人攻击
HTTPS 在电商与支付兴起的背景下应运而生,其本质上是一个组合协议,由 HTTP 实现数据可靠传输,SSL / TLS 实现身份安全认证,HTTPS 连接的建立顺序如下
- TCP 三次握手
- TLS 握手
- HTTP 加密传输
在实际应用中,HTTPS 引入密钥协商、对称加密、数字证书、哈希摘要等技术来保证数据隐私、身份可信以及消息完整性,具体而言
- 使用非对称加密 + 对称加密的混合加密机制,如采用 RSA/ECC 进行密钥协商,AES 进行加密传输
- 利用数字证书证明服务端可信:服务器需要向权威的证书颁发机构(CA)申请包含自身身份信息的数字证书,客户端(浏览器)在建立连接时,会验证服务器证书的合法性:若证书无效(如伪造、过期),浏览器会弹出安全警告,提醒用户 “该网站不安全”
- 消息认证机制保证消息完整性:服务器会对传输的数据生成哈希摘要,并通过密钥进行签名,接收方在解密数据后,会重新计算哈希值并与签名比对:若不一致,说明数据已被篡改,直接丢弃数据包
SSL / TLS 握手过程
数字证书如何保证其可信度 → 证书链
# TCP 连接
TCP 报文头部字段
三次握手
四次挥手
- 客户端:FIN-WAIT-1/2 + TIME-WAIT + CLOSED
- 服务器:CLOSE-WAIT + LAST-ACK + CLOSED
为什么都是一次请求一次确认,挥手要四次,握手只需要三次?
- 握手实际上是服务端在一次发送里同时进行了确认和请求,所以少了一次
- 但在挥手时不能这么做,因为需要等待数据传输完,有等待时间,例如 server 收到 FIN 请求后,还有 50KB 数据在传,所以要等传完之后,再发 FIN 请求告知自己不会再传了;此时 client 虽然发了 FIN,但也只是不传输,但仍接收
# SYN Flood 泛洪攻击
TCP 握手 SYN 泛洪攻击(SYN Flood):TCP 建立连接的三次握手,服务端(被动一方)必须严格按照这个程序来进行,即对客户端始终响应,如果客户端发送 SYN 包企图与服务端建立连接,但发送完 SYN 包后就不管,那会发送什么事情捏
- 客户端发送一个 SYN 包给服务端后就退出,而服务端接收到 SYN 包后,会回复一个 SYN+ACK 包给客户端,然后等待客户端回复一个 ACK 包
- 但此时客户端并不会回复 ACK 包,所以服务端只能一直等待直到超时,服务端超时后,会重发 SYN+ACK 包给客户端,默认重试 5 次,而且每次等待的时间都会增加(可以参考 TCP 协议超时重传的实现)
- 另外,当服务端接收到 SYN 包后,会建立一个半连接状态的 Socket,所以,当客户端一直发送 SYN 包,但不回复 ACK 包,那么将会耗尽服务端的资源,这就是 SYN Flood 攻击
# 静态代码分析
业务是皮,安全是毛,毛在皮身上
静态代码分析(SCA)是在不运行程序的前提下分析源码/字节码,发现缺陷与漏洞。大体分两条路:SCA 工具链(可直接用的现成工具)和 LSP + 语义分析(自己搭的精准分析)。
# SCA 基础
# 分析什么、用什么工具
检查范围:语法错误、代码规范、潜在 bug(空指针/越界/资源未关闭)、安全漏洞(注入/XSS/路径遍历)、性能与可维护性问题、设计坏味道。
常见工具,按语言分:
| 语言 | 工具 |
|---|---|
| Java | SonarQube、SpotBugs(查字节码)、PMD、Checkstyle |
| Python | pylint / flake8 / mypy |
| JS | ESLint |
| C/C++ | cppcheck / clang-tidy / Coverity |
| 多语言 | Semgrep(模式匹配规则)、CodeQL(类 SQL 的代码查询) |
落地方式:CI/CD 里集成(GitHub / GitLab / Jenkins 的 PR 流程),或用 IDE 插件实时检查。SonarQube 是部署 Server + sonar-scanner 上传结果,浏览器看 bugs / smells / 漏洞 / 重复代码。
# 原理:像编译器前端
flowchart TD
A[源代码] --> B[词法分析 Lexer]
B --> C[语法分析 Parser → AST]
C --> D[语义分析: 类型推断/符号绑定]
D --> E[控制流 CFA + 数据流 DFA]
E --> F[规则/模式匹配: Lint / Semgrep / CodeQL]
F --> G[警告 / 错误 / 报告]
2
3
4
5
6
7
- CFA:构建控制流图(CFG),分析条件/循环/分支,判断可达性与分支覆盖
- DFA:分析变量定义-使用链、是否初始化/为空,典型如空指针、资源未关闭
- 模式匹配:用规则集匹配代码结构,如 Checkstyle 查类名大写、Semgrep 匹配
password = "..." - 进阶方法:符号执行(路径覆盖)、抽象解释(近似建模)、模型检测(状态机验证)、AI 辅助修复
# LSP 与 JDT-LS
LSP(Language Server Protocol)是 IDE 与语言服务器之间的通信协议,定义了"转到定义""查找引用"等请求/响应。Java 侧常用 Eclipse JDT-LS。
# 整体架构
一个 Java 语言分析服务分四层,各司其职:
flowchart LR
CFG[LanguageServerConfig<br/>读配置] --> PROC[LanguageServerProcess<br/>启动 jdt-ls 子进程]
PROC --> CONN[LanguageServerConnection<br/>建立双向通信]
CONN --> CLI[LanguageServerClient<br/>接收服务端推送]
CONN --> SVC[LanguageServerService<br/>对外提供分析能力]
CLI -- publishDiagnostics 回调解锁 --> SVC
SVC -- 通过 launcher 发请求 --> CONN
2
3
4
5
6
7
- Config:
application.yml配host/port/jar-path/config-path/workspace,注入LanguageServerConfig - Process:
ProcessBuilder(command).start()启动 jdt-ls,持有进程的输入输出流。启动命令关键是-jar launcher.jar -configuration config_dir -data workspace - Connection:用 lsp4j 的
LSPLauncher.createClientLauncher(client, in, out)建Launcher<LanguageServer>,startListening()后拿到远端代理server - Client:实现
LanguageClient接口,接收服务端推送 - Service:实现主要分析能力(见下)
# 异步打开文件的锁机制
LSP 的 didOpen 是异步的:打开后要等服务端 publishDiagnostics 回送才算真正就绪。用一个 Map<uri, CompletableFuture<Void>> lock 协调:
sequenceDiagram
participant S as Service
participant LS as Language Server
participant C as Client
S->>LS: didOpen(file) + lock.put(uri, future)
S->>S: waitUntilFileReady (future.get 超时 2s)
LS-->>C: publishDiagnostics(uri)
C->>S: completeFuture(uri) → future.complete → 解锁
S->>S: 继续执行分析请求
2
3
4
5
6
7
8
9
- 打开目录时遍历所有
.java文件 didOpen,逐个等解锁;超时的 file 记入 failedFiles completeFuture由 Client 回调,是异步工作流的关键汇合点- Client 的其余推送方法(
logMessage/showMessage/applyEdit/configuration/registerCapability等)在无头场景下只需记录日志或返回空值,不必实现完整逻辑
# 对外提供的分析能力
| 能力 | 做法 |
|---|---|
| 取函数体 | documentSymbol 拿 AST → 按名字递归找 DocumentSymbol → 按 Range 取源码行 |
| 查找引用 | references 拿 Location 列表 → 每个位置反查所在函数 → 组装 caller |
| 调用链 | 以目标函数为根 BFS 遍历引用树,dfs() 输出 A -> B -> C 链条 |
| 转到定义 | 在方法体中定位 call 字符串的 Position → definition 请求 → 取定义处源码 |
| 符号搜索 | workspaceService.symbol 全工作区查符号 |
跨文件引用有时找不全,通常是相关文件没 didOpen。调用链为 1 时说明只有自身定义、没有真实调用。
完整实现代码见:LanguageClient.java(Client 端推送回调)、LanguageServer.java(Service 端分析能力)。
# JavaParser 分析
LSP + JP 方案获取调用链
LSP 基于符号解析,但对"接口实例化后到底调谁"这类问题不够准。JavaParser 能做语义分析、识别真正的实例化对象,两者搭配得到准确调用链。
核心类:
| 类 | 功能 |
|---|---|
JavaParser | 解析源码构建 AST |
JavaSymbolSolver | 静态符号解析(变量/方法/类的引用) |
CombinedTypeSolver | 提供类路径类型信息(JRE / 源码 / 依赖 jar) |
处理流程:
flowchart LR
A[ProjectAnalyzer<br/>遍历目录建 AST] --> B[JsonGenerator<br/>遍历 AST 提取类/方法/调用]
B --> C[输出 JSON 信息]
C --> D[存入 H2DB 调用链表]
D --> E[LLM Select 查表拿代码信息]
2
3
4
5
ProjectAnalyzer:遍历目录下.java,StaticJavaParser.parse出CompilationUnit,存path→source和path→AST两个 MapJsonGenerator:遍历 AST,对每个类/方法提取 methodName、returnType、parameters,findAll(MethodCallExpr)抓调用名,Gson 序列化- 存储记录形如
{id, uri, reference_uri, reference_name},落 H2DB,LLM 需要时查表
完整实现见:ProjectAnalyzer.java、MethodInfo.java、JsonGenerator.java。
# 安全编码
前面讲"怎么发现代码里的问题",这里讲"怎么写就不容易出问题"。核心原则:非侵入式——新增需求尽量不改已有逻辑。
# 非侵入式编码
四种手法:
1. 函数变长入参:用 opt ...AllocOperateOpt 代替 args ...string,定义强类型的选项函数(如 WithCollaboratorAuth(envID, role))。原来调用一行不动,新参数有名字、可读性强。
2. 参数外置/内置:
- 外置:已有函数不动,外面封装一层
XXXByEnvId,内部查到 username 再调原函数 - 内置:抽象出底层
QueryThirdPartyTokenByUsername(ctx, origin, deleted, username),让原函数退化为一行转发return its.QueryThirdPartyTokenByUsername(..., ctx.UserName()),需求直接调底层函数
3. 配置化编码:配置内容越简单越不容易错。下拉框版本的演进:JSON 对象 → 字符串数组 → 分号分隔字符串 "19.03;26.1",前端自己 split,避开 json.parse 的风险。
4. Hook 编码:用钩子实现业务逻辑,标准是"不需要项目本体发布就能实现需求",如网关钩子做日志统计、Java Agent 插桩追踪(注意 Spring AOP 只是侵入式较小,并非真正非侵入)。
# 防御性编程
三个不要:
- 不要相信上层输入 / 上游传参
- 不要向上层暴露底层信息
- 不要相信下游依赖,预留灰度开关兜底
第 3 条的落地:配置中心拉配置 + 后台 if 硬编码判断,命中才返回新字段,前端按开关决定是否展示,回滚只改配置不发版。示例:新增 sshDomain 时用独立的 EnableSshAppId 白名单,与既有功能灰度互不影响,先单 appId 验证再改配置扩量。
# Bug 追查
多服务排障三步:
- 先摸清报错原因,链路精确到 pod 级,不接受"admin 到 web-server"这种模糊描述
- 按阶段定位——逐段比对日志(哪一段字段丢了就锁定哪一层),配合按 pod id 查配置
- 代码与配置并重——只修代码不修配置照样不通