如何配置VS Code中的Azure Function 解决Charles Proxy调试时的SSL证书报错
这个报错的核心原因很直接:Charles开启HTTPS抓包后,会用自签根证书替换链路中的SSL证书,而本地运行的Azure Function Core Tools基于.NET运行时构建,默认不会自动读取Mac系统钥匙串里信任的Charles根证书;同时没有配置代理转发规则时,既走不通Charles的代理链路,又会被内置的证书校验逻辑拦截,最终启动失败。
前置准备
先把Charles本身的基础配置做对,排除系统层面的低级问题:
- 确认Charles本地代理端口为默认的
8888,保持代理服务处于运行状态 - 安装Charles的根证书到Mac系统钥匙串,将证书的信任规则设置为始终信任
- 在Charles的SSL代理配置里,加上你要调用的SSML生成API的域名规则,确保后续的HTTPS请求能被正常解密抓包
核心配置步骤
Azure Function运行时不会自动读取系统的代理设置,需要手动给VS Code和函数运行时注入代理、证书校验相关的环境变量:
1. 给VS Code集成终端注入环境变量
打开VS Code的settings.json配置文件,找到terminal.integrated.env.osx配置段,添加如下配置:
"terminal.integrated.env.osx": { "HTTP_PROXY": "http://127.0.0.1:8888", "HTTPS_PROXY": "http://127.0.0.1:8888", "NO_PROXY": "localhost,127.0.0.1,core.windows.net", # 本地调试专用,跳过Charles自签证书的校验 "DOTNET_SYSTEM_NET_HTTP_DISABLE_CERTIFICATE_VALIDATION": "true" }
配置里的NO_PROXY非常关键:如果不把本地地址排除出代理链路,连本地Azurite存储模拟器的请求都会被错误转发到Charles,直接触发日志里的Value cannot be null. (Parameter 'provider')报错。
2. 给函数运行时补全启动配置
VS Code的Azure Function扩展很多时候是独立拉起函数进程的,不会读取集成终端的环境变量,这时候需要在函数项目根目录下创建Properties/launchSettings.json文件,把上面的环境变量再配一遍,确保不管是从终端启动还是从扩展按钮启动,都能读到正确的参数。
3. 重启验证
完全退出VS Code(不要只关闭窗口,要彻底退出进程让环境变量生效),先打开Charles确认代理正常监听,再重新启动本地的Azure Function:
- 启动日志里不会再出现SSL证书校验失败的报错
- 触发函数执行SSML转音频的逻辑,就能在Charles的请求列表里看到函数发出的真实请求内容,直接和你其他正常应用的同接口请求做逐字段对比,快速定位空文件返回的原因
提醒:上面配置的跳过证书校验的规则仅适用于本地调试抓包场景,绝对不要把这类配置带到生产环境,否则会绕过SSL校验带来安全风险。
常见踩坑提醒
- 如果还是报证书错误,去钥匙串检查Charles根证书的信任级别,很多时候默认安装的证书只对浏览器生效,没有给本地.NET程序开放信任权限
- 之前遇到的“处理几个文件就返回空文件”的问题,大概率是免费版Charles的连接数/时长限制触发了代理断连,或者函数发出的请求没有正确携带订阅密钥、连接池耗尽被代理拦截,抓包后就能直观看到问题
内容的提问来源于stack exchange,提问作者otusweb

