You need to enable JavaScript to run this app. Next.js项目生产模式下Swiper.js导航按钮消失,开发环境显示正常
优惠活动
大模型
产品
解决方案
定价
更多

Next.js项目生产模式下Swiper.js导航按钮消失,开发环境显示正常

生产模式下Swiper.js导航按钮消失问题

Swiper.js导航按钮在开发环境可正常显示,但在生产环境中无法显示。

相关配置代码

next.config.js

const withSass = require('@zeit/next-sass');
const withCSS = require('@zeit/next-css');

module.exports = withCSS(withSass({
  webpack(config) {
    config.module.rules.push({
      test: /\.(png|jpg|gif|svg|eot|ttf|woff|woff2)$/,
      use: {
        loader: 'url-loader',
        options: {
          limit: 100000
        }
      }
    });

    return config;
  }
}));

_app.js 样式引入代码

import 'swiper/swiper.scss';
import 'swiper/css/swiper.css';
import 'swiper/components/navigation/navigation.scss';
import 'swiper/components/pagination/pagination.scss';
import 'swiper/components/scrollbar/scrollbar.scss';
import 'swiper/components/effect-cube/effect-cube.scss';

业务组件Swiper初始化代码

SwiperCore.use([Navigation, Scrollbar, A11y]);

 <Swiper  
          threshold="50"
          navigation
          style={{ width: '100%', height: '98%', }}
          scrollbar={{ draggable: true }}
          initialSlide={sliderIndex}    
        >
          <SwiperSlide className={classes.slider}>
            {createPages(0, 8, 0)}
          </SwiperSlide>

          <SwiperSlide className={classes.slider}>
            {createPages(8, 16, 1)}
          </SwiperSlide>
</Swiper>

排查解决方向

  • 处理重复样式引入冲突:当前_app.js中同时引入了Swiper全量样式和拆分组件样式,生产环境执行CSS Tree Shaking、压缩合并时,极易出现样式覆盖、部分规则丢失的问题,先移除重复的全量样式引入,删掉import 'swiper/swiper.scss';、import 'swiper/css/swiper.css';两行代码,仅保留业务实际用到的拆分组件样式引入。
  • 检查资源加载状态:Swiper导航按钮默认的箭头图标为svg格式的小体积资源,可在生产环境打开浏览器开发者工具,选中导航按钮DOM元素查看计算样式:如果是背景图资源加载失败,就调整url-loader对svg资源的处理配置,确保小资源可以正确转码加载;如果元素本身被设置为隐藏状态,继续排查初始化逻辑问题。
  • 修复导航元素匹配问题:Swiper的Navigation组件默认会自动挂载类名为.swiper-button-prev、.swiper-button-next的DOM元素作为导航按钮,生产环境如果开启了类名hash化、CSS Modules处理,自动生成的元素类名和样式文件中的选择器可能出现匹配失效的情况,可以手动在Swiper组件的navigation属性中指定对应导航元素的选择器,避免自动查找逻辑失效。
  • 替换过时的样式处理插件:当前使用的@zeit/next-css、@zeit/next-sass属于已停止维护的旧版插件,对拆分式引入的组件样式提取兼容性较差,很容易出现部分样式规则没有被打包到生产产物中的问题。如果使用的是Next.js 11及以上版本,可以直接使用框架内置的CSS、Sass支持能力,移除旧插件的配置,解决样式打包丢失的问题。

内容的提问来源于stack exchange,提问作者Burhan Keskin

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.01 16:24:04