COS/S3接入需五步：一验证服务与密钥有效性；二修改application.yml中storage配置；三重启服务并确认日志初始化成功；四上传测试文件并校验URL与控制台文件；五排查SignatureDoesNotMatch和NoSuchBucket错误。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已完成WorkBuddy的安装，但对象存储（COS/S3）尚未生效，则可能是由于配置项未正确写入或服务端未加载新参数。以下是完成COS/S3接入的具体操作步骤：
一、确认对象存储服务类型与凭证有效性
WorkBuddy支持腾讯云COS与兼容S3协议的对象存储，需先验证所用服务是否可达且密钥具备读写权限。若凭证错误或Endpoint不可达，后续所有配置均无法生效。
1、登录对应云服务商控制台，进入对象存储服务管理页，复制Bucket名称、Region、Endpoint（如cos.ap-shanghai.myqcloud.com或s3.amazonaws.com）。
2、在密钥管理模块中生成或定位已启用的AccessKey ID与SecretAccessKey，确保该密钥具有PutObject、GetObject、ListObjectsV2权限。
3、使用curl命令验证Endpoint连通性：curl -I https://your-endpoint，返回HTTP 200或403表示网络可达；若超时或拒绝连接，需检查防火墙或代理设置。
二、修改WorkBuddy配置文件中的存储模块参数
WorkBuddy通过application.yml或application.properties加载对象存储配置，必须确保storage.type字段明确指定为cos或s3，并填入完整认证与区域信息。
1、进入WorkBuddy部署目录，打开config/application.yml文件。
2、定位到storage节点，在其下添加或替换以下内容（以COS为例）：
storage:
type: cos
cos:
bucket: your-bucket-name
region: ap-shanghai
secret-id: AKIDxxxxxxxxxxxxxxxxxxxxxxxxxxxx
secret-key: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
endpoint: https://cos.ap-shanghai.myqcloud.com
3、若使用S3兼容服务（如MinIO、华为OBS），将type改为s3，并替换s3节点下的bucket、endpoint、access-key、secret-key字段，region可留空或设为custom。
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
三、重启WorkBuddy服务并验证配置加载状态
配置文件变更后，WorkBuddy不会自动热重载对象存储参数，必须重启JVM进程使新配置注入Spring上下文。
1、执行命令停止当前服务：kill -15 $(cat workbuddy.pid)（若使用pid文件）或通过systemctl stop workbuddy（若为systemd服务）。
2、清除临时类加载缓存：rm -rf ./target/tomcat.*（若为内嵌Tomcat）或删除work/temp目录。
3、重新启动服务：nohup java -jar workbuddy.jar --spring.config.location=config/ > logs/start.log 2>&1 &。
4、查看logs/application.log，搜索关键字"StorageConfiguration initialized with type: cos"或"S3AsyncClient created for endpoint"，确认初始化成功。
四、上传测试文件并校验对象存储写入路径
WorkBuddy默认将附件存入bucket根目录下的upload子路径，需手动触发一次文件上传操作，验证路径生成逻辑与权限是否匹配。
1、登录WorkBuddy Web界面，进入任意支持附件上传的表单页面（如工单提交页）。
2、选择一张小于5MB的PNG图片，点击上传按钮。
3、上传完成后，打开浏览器开发者工具，在Network标签页中查找返回JSON响应，提取fileUrl字段值。
4、将fileUrl中的域名部分替换为COS/S3控制台提供的访问域名，拼接完整URL后在新标签页打开，确认图片可正常渲染。
5、登录对象存储控制台，进入对应Bucket的upload目录，确认该文件已存在且LastModified时间与上传时刻一致。
五、处理常见报错：SignatureDoesNotMatch与NoSuchBucket
这两个错误分别指向签名计算失败与Bucket不存在或区域不匹配，多因SecretKey错误、Region填写偏差或Endpoint格式不规范导致，需逐项排查。
1、检查application.yml中secret-key是否包含前后空格或换行符，建议全选复制后粘贴至文本编辑器中启用“显示不可见字符”功能验证。
2、确认Region值与Bucket实际所在地域严格一致，例如COS上海地域必须填ap-shanghai，不可简写为shanghai或cn-shanghai。
3、对于S3兼容服务，endpoint必须以https://开头且不带路径段，错误示例：https://minio.example.com:9000/storage，正确应为https://minio.example.com:9000。
4、若使用自签名证书的私有S3服务，需在WorkBuddy启动参数中添加：-Dcom.amazonaws.sdk.disableCertChecking=true，并确保application.yml中s3节点下配置ssl-enabled: false。
