证书过期报错需依次校准系统时间、清除Qoder SSL缓存、更新根证书存储、配置insecure_hosts跳过验证（仅内网）、更新内置certifi证书包。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用Qoder时遇到“证书过期”报错，导致HTTPS连接失败或无法访问私有仓库，则可能是由于Qoder客户端信任的证书链异常、本地系统时间偏差、私有仓库服务端证书真实过期，或Qoder自身缓存了失效的TLS会话凭证所致。以下是解决此问题的步骤：
一、校准设备系统时间与启用网络时间同步
Qoder依赖本地系统时间验证HTTPS证书有效期。若设备年份错误、时钟偏移超过5分钟，即使服务端证书有效，Qoder也会拒绝建立连接并抛出“证书过期”类错误。
1、在Windows系统中，右键任务栏时间→选择“调整日期和时间”→开启“自动设置时间”和“自动设置时区”。
2、在macOS中，打开“系统设置”→“通用”→“日期与时间”→勾选“自动设定日期与时间”。
3、在Linux终端执行：sudo timedatectl set-ntp true，并运行timedatectl status确认NTP服务已激活。
4、完成同步后，关闭所有Qoder进程（含后台服务），重新启动Qoder主程序。
二、清除Qoder本地SSL/TLS会话缓存与证书状态
Qoder在运行过程中会缓存TLS会话票据、OCSP响应及证书吊销检查结果。若缓存中存在已过期的凭据或陈旧的中间证书链信息，将导致后续HTTPS请求持续复用失效状态，触发证书验证失败。
1、完全退出Qoder：右键系统托盘图标→选择“退出”，确保进程列表中无qoder或lingma相关项。
2、定位并删除SSL缓存目录：Windows路径为%APPDATA%\Qoder\SSLCache；macOS路径为~/Library/Caches/Qoder/SSLCache；Linux路径为~/.cache/Qoder/SSLCache。
3、若目录不存在，手动创建空SSLCache文件夹后立即删除，以强制Qoder重建安全上下文。
4、重启Qoder并尝试重新连接私有仓库地址。
三、验证并替换Qoder信任的根证书存储
Qoder默认使用系统级CA证书库，但部分企业环境或旧版Qoder可能嵌入了过期的自签名根证书（如FiddlerRoot、Charles Proxy、内部CA），导致对合法HTTPS站点（包括私有PyPI仓库）的证书链验证中断。
1、以管理员身份运行命令提示符（Windows）或终端（macOS/Linux）。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
2、执行命令导出当前可信根证书快照：certutil -generateSSTFromWU roots.sst（Windows）；macOS执行：sudo security find-trusted-root-certs -p > /tmp/roots.pem。
3、双击生成的roots.sst文件（Windows）或导入/tmp/roots.pem（macOS）至系统信任库，指定目标为“受信任的根证书颁发机构”。
4、重启Qoder进程，观察是否仍提示证书链不可信。
四、配置Qoder跳过特定域名的证书验证（仅限可信内网）
对于使用自签名证书的私有仓库（如GitLab PyPI、Nexus Repository Manager），Qoder默认拒绝连接。在确认该仓库部署于物理隔离、无中间人风险的内网环境中，可临时禁用其HTTPS证书验证机制。
1、关闭Qoder，打开配置文件：C:\Users\[用户名]\AppData\Local\.lingma\config.json（Windows）或~/.lingma/config.json（macOS/Linux）。
2、在JSON根对象中添加字段："strict_ssl": false。
3、若需仅对特定域名禁用验证，添加："insecure_hosts": ["pypi.internal.company.com", "nexus.company.local"]。
4、保存文件，彻底结束Qoder进程后重新启动。
五、更新Qoder内置证书捆绑包（Bundle）
Qoder 2.x版本起内置Mozilla CA证书包（certifi），若长期未更新，可能缺失新CA（如ISRG Root X2）或已撤销旧CA（如DST Root CA X3），造成对现代HTTPS站点的验证失败。
1、进入Qoder安装目录下的resources子目录，查找名为cacert.pem或certifi.pem的文件。
2、从官方certifi仓库下载最新证书包：https://raw.githubusercontent.com/certifi/python-certifi/main/certifi/cacert.pem。
3、备份原文件，将下载的cacert.pem复制覆盖原位置。
4、重启Qoder，执行一次pip install -r requirements.txt测试私有仓拉取是否恢复。
