Files
hjc-web/outputs/oss-upload-guide-2026-07-30.md
T
gxwebsoft 2b69686795 feat(app): 添加多模板关于我们页面及相关路由和404页面
- 新增404页面,优化未找到页面体验,避免被搜索引擎索引
- 增加文件代理接口,隐藏真实文件服务器地址,支持文件请求代理
- 实现/article、/case、/product及/page动态路由兼容列表与详情展示
- 添加动态CMS页面兼容入口处理旧式路径,统一路由与SEO设置
- 新增模板1、模板7、模板2、模板3关于我们页面,实现多模板支持
- 模板增强支持CMS单页内容加载及SEO信息动态设置
- 配置环境变量及Git忽略文件规则辅助开发和构建环境管理
2026-09-08 12:13:44 +08:00

2.2 KiB
Raw Blame History

图片上传 + 后台接入记录(2026-07-30

上传接口正确调用方式(关键!)

https://server.websoft.top/api/oss/uploadmultipart 文件上传,必填项:

  • Authorization: Bearer <admin JWT>
  • tenantId: 10626(请求头,缺它报「传参错误」——这是之前一直失败的根因)
  • form 字段 file=@图片

其余 module/bizType/path 等字段可选,不传也能成功。返回 data.path / data.url 即访问地址。

探测过程踩的坑:OpenAPI(swagger) 文档是 springfox 自动生成的,不收录 @RequestParam,误导以为要 application/octet-stream 或各种 form 字段。实际是 multipart + tenantId 请求头。

本次上传结果

图片 OSS 地址 用途
关于我们右侧图 https://oss.wsdns.cn/20260730/e31b250f922643b0ada4338897840d47.jpg 模板本地兜底 public/images/template-07/about.jpg 同源(后端无 aboutImage 字段,走本地兜底显示)
最新动态首图 https://oss.wsdns.cn/20260730/082146c2149b4175ad08e71534c12682.jpg 已写入 cms-article 10557 的 image 字段(PUT /api/cms/cms-article

后台写入

  • 文章 10557「走近汇采聚云…」image 原值 file.websoft.top/.../b798...png 已 404,改为新 OSS 图。PUT /api/cms/cms-articletenantId 头 + 完整 article JSON)。
  • 关于我们图:后端 cms-website/getSiteInfo 是扁平结构,aboutImage / config 子对象(只有 websiteLogoqrCode 等),故模板用本地兜底图 public/images/template-{01,07}/about.jpg。若需后台托管,需在站点配置加 aboutImage 字段并让前端读 siteInfo.config.aboutImageHome.vue 已预留该优先级)。

前端已确认渲染(dev server :3002

  • 关于我们右侧:/images/template-07/about.jpg(生成图,非 Logo
  • 最新动态首图:https://oss.wsdns.cn/20260730/082146...jpg(后端 article.image
  • 关注我们二维码:siteInfo.qrCodehttps://oss.wsdns.cn/20260729/00d3fc...png,读后台,无硬编码)

复用的上传脚本

scripts/upload-to-oss.shADMIN_TOKEN="eyJ..." bash scripts/upload-to-oss.sh