error 500是服务端异常，非本地安装包问题；需先定位错误发生位置（安装中或启动后），再检查本地干扰进程、禁用联网校验、启用调试日志、curl直连诊断。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在WorkBuddy安装过程中遇到Error 500提示，该错误通常并非出现在客户端安装阶段，而是指向服务端响应异常——这意味着安装程序可能已成功执行本地操作，但在尝试连接或注册WorkBuddy后端服务（如codebuddy.cn域名下API）时，服务器返回了“500 Internal Server Error”。此类报错常见于服务端过载、鉴权中间件崩溃或配置热更新失败等场景。以下是针对性的后台进程调试与绕行处理步骤：
一、确认错误真实发生位置
区分是本地安装进程报错，还是安装完成后首次启动/登录时触发的500错误，是调试前提。Error 500属于HTTP服务端错误，不可能由纯本地安装包（.exe/.dmg/.apk）自身抛出；若安装程序界面直接显示“Error 500”，极大概率是其内嵌的Web installer组件尝试调用远程接口失败。
1、观察报错弹窗是否含URL地址（如https://workbuddy.codebuddy.cn/api/v1/install/verify）。
2、若无URL但出现OpenResty、nginx或Java线程堆栈字样，说明错误来自腾讯云部署的网关层，非本机问题。
3、打开系统任务管理器（Windows）或活动监视器（macOS），搜索是否存在名为“workbuddy-backend”、“codebuddy-server”或“electron-node”进程——若存在且CPU/内存占用持续100%，则为本地模拟服务异常。
二、检查并终止干扰性本地后台服务
WorkBuddy桌面端（v3.x起）默认启用本地代理服务用于离线技能调度，若该服务端口被占用或配置损坏，可能伪造500响应给主进程。
1、按下Ctrl+Shift+I（Windows/Linux）或Cmd+Option+I（macOS）在WorkBuddy启动界面打开开发者工具，切换至Console标签页，查找含“500”或“failed to fetch”的红色报错行。
2、记录报错中出现的本地端口（常见为52001、52002或8080）。
3、在终端（macOS/Linux）或命令提示符（Windows）中执行：lsof -i :52001（macOS/Linux）或netstat -ano | findstr :52001（Windows），定位占用进程PID。
4、执行kill -9 [PID]（macOS/Linux）或taskkill /F /PID [PID]（Windows）强制结束该进程。
三、禁用自动服务连接进行离线安装验证
跳过所有联网校验环节，强制完成本地安装流程，可排除服务端故障对安装动作本身的干扰。
1、Windows用户：以管理员身份运行PowerShell，执行：Set-ItemProperty -Path "HKLM:\SOFTWARE\Policies\Microsoft\Windows\NetworkProvider\HardenedPaths" -Name "\workbuddy.codebuddy.cn\*" -Value "RequireMutualAuthentication=0, RequireIntegrity=0"。
2、macOS用户：在终端执行：sudo defaults write /Library/Preferences/com.apple.networkd AllowLocalhostOnly -bool YES，随后重启网络服务：sudo launchctl kickstart -k system/com.apple.networkd。
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
3、Android用户：进入“设置→开发者选项”，启用“停用网络检查”，再返回重新点击APK安装。
4、全部平台通用：安装前断开Wi-Fi/移动数据，仅保留USB网络共享（如有）或完全离线，安装完毕后再联网激活。
四、手动注入调试日志开关
启用WorkBuddy底层Electron框架的详细日志输出，捕获500请求的完整上下文（包括Header、Body、证书链、重定向路径）。
1、Windows：右键WorkBuddy快捷方式→“属性”→在“目标”栏末尾添加空格及--log-level=4 --enable-logging --v=1，点击确定后运行。
2、macOS：在终端中执行：/Applications/WorkBuddy.app/Contents/MacOS/WorkBuddy --log-level=4 --enable-logging --v=1 > ~/Desktop/workbuddy-debug.log 2>&1。
3、Linux：编辑~/.local/share/applications/workbuddy.desktop，在Exec=行末尾追加 --log-level=4 --enable-logging --v=1，保存后重新启动应用。
4、安装过程结束后，立即打开生成的日志文件，搜索"500"、"status: 500"或"internal server error"，定位最邻近的HTTP请求URL与时间戳。
五、使用curl直连诊断服务健康状态
绕过WorkBuddy客户端，直接向官方服务端发起标准化HTTP请求，验证是否全局性500故障，或仅为当前网络出口受限。
1、复制报错日志中出现的完整API URL（例如https://workbuddy.codebuddy.cn/api/v1/auth/ping）。
2、在终端执行：curl -v -X GET "[URL]" -H "User-Agent: WorkBuddy-Installer/3.2.1"（将[URL]替换为实际地址）。
3、观察响应头中的Server字段（如openresty/1.21.4.2）及X-RateLimit-Remaining值，若返回429 Too Many Requests，说明IP已被限流，需更换网络环境。
4、若curl返回500且响应体含"java.lang.NullPointerException"或"Failed to instantiate WebApplicationInitializer"，证实为服务端JVM层崩溃，此时应等待官方修复，无需本地操作。
