H5 图片路径不统一,导致线上部分图片无法按预期展示(assetPrefix 与 basePath 行为不一致)

问题:H5网页头像,点赞和评论icon没有出现

  • 环境:
    • 构建: Next.js 13.2.4
    • 配置: assetPrefix = '/pr',basePath 未开启
  • 影响范围:
    • 页面: H5 页面
    • 资源: 小图标/本地图(thumbsup.png、comment.png 等)
  • 现象: 在浏览器中
    • logo 正常:请求路径为 /pr/_next/static/media/logo.xxx.png
    • 其他图片异常:路径为 /_next/image?url=%2Fpr%2Fthumbsup.png...(优化路由未带 /pr 前缀),浏览器 Sources 下看不到对应 /_next/static/media/* 条目
  • 预期:
    • 所有图片路径风格统一,均能在 test 环境正常展示;优化路由或静态直链应一致且带正确前缀
  • 初步根因分析:
    • Next 的图片优化端点 /_next/image 不受 assetPrefix 影响,仅受 basePath 控制;当前仅配置了 assetPrefix,未开启 basePath,导致优化路由与静态直链前缀不一致
    • 组件内图片用法不统一:部分使用静态导入+自定义 loader(绕过优化),部分使用字符串路径(触发优化路由)
  • 相关证据:
    • 本地构建产物存在 /.next/static/media/thumbsup..png、comment..png
    • 线上通过浏览器面板 Network发现:logo 在路径 /pr/_next/static/media/...下;但是没有thumbsup和comment
  • 修复方案:
    • 统一使用静态导入并禁用优化:
    • import thumbsup from '@/public/thumbsup.png'
    • <Image src={thumbsup} width={22} height={22} unoptimized /> 或 <Image src={thumbsup} width={22} height={22} loader={({src}) => src}/>
相关推荐
用户97887605390488 小时前
Canvas 处理大图时如何不卡住主线程:一次浏览器端批量压缩的调度实践
前端
鶴哥只手遮天8 小时前
# 《Electron 45.2.3 内核解剖》第 6 章 Node.js 集成:两个事件循环的婚姻
前端·electron·开源
bai2738 小时前
别再手动刷后台了:用原生 CDP 给 4 个内容平台做登录态保活心跳
前端
工程小白菜8 小时前
AI 生成的代码谁来验收?从 Copilot 到 WorkBuddy 的三个实践
前端·ai编程
我不会起名字3229 小时前
仅 Web 主动 ping:30 秒读超时与各平台保活
前端·后端·websocket·go·即时通讯·im·故障排查
徐小夕9 小时前
CADViewer-Skill:让 Agent 原生支持 DWG 解析、可视化图统计、图纸导出
前端·vue.js·github
Mh9 小时前
AI 的模型能力越来越强,为什么我的编码能力越来越弱?
前端·javascript·后端
deli0079 小时前
1 万条数据渲染卡成 PPT?虚拟列表把 DOM 从 10000 降到 24
前端
jay神9 小时前
基于 YOLOv8 的传送带异物检测系统(Web 版)
前端·人工智能·深度学习·yolo·计算机视觉·计算机毕业设计
黑土豆10 小时前
网页框一下就能截图Region-snap:我把这套功能封装成了 npm 包,支持 Vue 和 React
前端·javascript·npm