收到“非法请求源”提示是因referer头未通过服务端校验，需依次确认实际referer值、检查后台白名单配置、修正前端部署路径与referer生成逻辑，测试环境可临时关闭校验。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用WorkBuddy时收到“非法请求源”的提示，通常是由于当前请求的Referer头未通过服务端校验。以下是解决此问题的步骤：
一、确认当前请求的实际Referer值
浏览器发起请求时会自动携带Referer字段，该字段标识请求来源页面的URL。服务端依据此值与预设白名单比对，不匹配则拒绝请求。需先获取真实Referer以验证是否符合白名单规则。
1、打开浏览器开发者工具（通常按F12键）。
2、切换至Network（网络）选项卡，并刷新触发报错的页面或操作。
3、在请求列表中找到对应接口（如/api/v1/xxx），点击进入详情页。
4、在Headers标签下查找Request Headers区域中的Referer字段值。
二、检查WorkBuddy后台Referer白名单配置
Referer白名单由WorkBuddy管理后台统一维护，仅允许列表内域名或路径前缀发起合法请求。若实际Referer不在白名单中，将被拦截。
1、使用管理员账号登录WorkBuddy控制台。
2、进入【系统设置】→【安全中心】→【Referer白名单】页面。
3、查看已启用的白名单条目，确认是否包含步骤一中获取的Referer完整域名（例如https://example.com）或其父级域名（例如example.com）。
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
4、若不存在，点击【新增】按钮，输入精确匹配的协议+域名+端口（如https://app.workbuddy.local:8080），保存后等待策略生效。
三、修正前端页面部署路径与Referer生成逻辑
某些部署方式会导致Referer值异常，例如使用file://协议打开HTML文件、本地服务器未配置Host头、或Nginx反向代理未透传原始Referer。此时需调整前端环境以生成合规Referer。
1、避免直接双击HTML文件运行，应通过本地HTTP服务访问（如使用python3 -m http.server 8000）。
2、检查Nginx配置中是否存在proxy_set_header Referer "";指令，如有则注释或删除该行。
3、确认前端构建产物部署在与白名单一致的域名和端口下，例如白名单为https://workbuddy.example.com，则应用必须从此地址访问，不可用IP或localhost替代。
四、临时绕过Referer校验（仅限测试环境）
在开发调试阶段，可临时关闭Referer校验以快速定位问题是否源于该机制。此操作不可用于生产环境。
1、登录WorkBuddy服务器，定位配置文件（通常为application.yml或config.json）。
2、查找referer-check-enabled、security.referer.enabled等类似字段。
3、将其值修改为false并保存文件。
4、重启WorkBuddy服务进程使配置生效。
