简介NiuShop开源商城小程序SAAS版是一款成熟的电商建站系统面向微信生态的商城业务适合中小微企业、创业团队及PHP开发者快速搭建微信商城、小程序商城。源码为稳定版支持免费商用内置分销、团购、直播、秒杀、优惠券、自定义页面等功能模块且采用插件化架构各功能相互解耦便于按需安装、灵活组合与二次开发能够覆盖新零售场景下的主要营销玩法。资源包以zip格式压缩整体体积约61.02MB包含后端程序逻辑、小程序前端工程及相关配置文件可直接部署测试并根据业务需求扩展新增功能。这套源码代码结构清晰注释规范插件市场预留扩展位可明显缩短从需求梳理到上线部署的周期。目前已有598人浏览学习对外包费用有限、希望低成本获得可商用商城源码的团队尤其有价值。1. Niushop 开源商城小程序 SAAS 版先别急着装这东西解决什么问题、值不值得用Niushop 开源商城小程序 SAAS 版一句话讲清楚这是一套基于 PHP 的、自带微信小程序端商城的开源商城源码按 SaaS 多租户思路设计公开可下载、支持免费商用、核心代码可改。你拿它做的不是单店小程序而是一个「自己能开店、也能让别的商户入驻开店」的商城系统。市面上很多小程序商城源码只给一套前后端Niushop 这套特别在把「站点管理、商户套餐、应用隔离」都做进了后台天生不是为单店准备的。它解决的实际问题是省掉从零写订单、购物车、支付回调、会员、营销插件的工作量也不让你陷入「演示版流畅、一买授权就崩」的套路。你拿到源码后常见的做法是部署一套 Niushop 后台再编译小程序端对接微信的 AppID 和支付商户号然后把商城链接下发给商户用。适合的人很具体做源码建站的团队、接小程序外包的开发者、想自己搭一套多商户商城并长期运营的商家。下文从部署、对接小程序、理解 SAAS 逻辑到排坑全按一线实操讲。2. 把 Niushop SAAS 版跑起来LNMP 环境、源码目录与最小启动命令2.1 环境选型LNMP 是下限不是上限Niushop 是 PHP 项目生产环境最稳的组合是 LNMPLinux Nginx MySQL PHP不要用 Apache 硬扛Nginx 的伪静态和并发处理在商城这种读多写少的场景下明显占优。PHP 版本别图新先看源码里要求的 PHP 版本Niushop 老版本常见跑在 PHP 7.x新版本对 PHP 8 的支持要看 release 说明我一般直接装 PHP 7.4兼容性最稳PHP 8 的强类型报错会打乱排查节奏。MySQL 用 5.7 或 8.0 都可以注意字符集统一 utf8mb4否则商品详情里的 emoji 会变成问号。Redis 建议装但不建议一开始就启用Niushop 的缓存、购物车、临时登录态会用到 Redis如果部署机内存只有 2G第一周可以先关掉把 Redis 留到上线前再开。下面是环境安装的最小命令Debian/Ubuntu 系直接跑# 安装基础环境这里以 Ubuntu 20.04 / PHP 7.4 为例 sudo apt update sudo apt install -y nginx mysql-server redis-server php7.4-fpm \ php7.4-mysql php7.4-curl php7.4-gd php7.4-mbstring \ php7.4-xml php7.4-zip php7.4-bcmath php7.4-redis # 确认版本 php -v nginx -v mysql --version参数说明php7.4-bcmath 是商城算价格、分账、优惠券分摊时必须的漏装会导致满减金额计算报错php7.4-redis 是为了后面开缓存php7.4-curl 用于微信支付、物流轨迹等外呼接口。装完先重启 php-fpm 让扩展生效。2.2 拿到源码后的第一眼目录结构决定了你的改法Niushop 这类成熟商城的源码解压后你会看到几个关键目录需要先认清楚不然很容易在错误的文件里找 bug。常见结构是application 里放后端模块public 是 Web 根目录Nginx 必须指到这里不能指到项目根addons 是插件目录runtime 是运行时缓存data 或 upload 目录放上传图片。我第一次部署时习惯性把 Nginx 根目录指到了项目根结果后台能打开、前端样式全丢因为入口文件在 public 下外部的静态资源路径全乱了。下载源码有两种方式一种是从官方仓库 git clone适合后续自己维护更新另一种是下载站长类站点打包好的压缩包适合快速验证。我不建议用后者直接上生产压缩包里可能带着别人改过的配置和残留数据。用 git 方式最小操作# 假设你已经把源码放到了 /var/www/niushop cd /var/www/niushop # 查看分支和版本信息 git branch -a # 创建 runtime 目录并给写权限这一步漏掉会导致页面空白或安装报错 mkdir -p runtime chmod -R 775 runtime chmod -R 775 upload data 2/dev/null || true # 查看目录结构 ls -la说明chmod 775 意味着所有者和组可读写部署时如果运行用户是 www-data要把目录所属改成 www-data否则安装向导写不了配置文件。不理解的团队会把权限一刀切设成 777这在单机测试没问题上了生产如果服务器被扫到风险较大。2.3 初始化数据库安装向导和手工导入二选一Niushop 的安装方式一般是浏览器访问站点域名走 install 向导但如果你的源码包不带安装向导或者向导因为权限问题写不了配置就得手工建库导 SQL。手工方式更适合自己掌握全流程的人因为安装向导会在你不知情时写入默认管理员密码你回头还得去改。手工导入步骤如下# 登录 MySQL创建库和专用账号避免用 root 连接商城 mysql -u root -p CREATE DATABASE niushop_saas DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; CREATE USER niushoplocalhost IDENTIFIED BY 这里换一个强密码; GRANT ALL PRIVILEGES ON niushop_saas.* TO niushoplocalhost; FLUSH PRIVILEGES; EXIT; # 在源码目录里找到 sql 文件一般是 install 目录或根目录下的 .sql 文件 ls -la *.sql install/ 2/dev/null # 导入数据库 mysql -uniushop -p niushop_saas /var/www/niushop/niushop_saas.sql注意导入之前先确认 SQL 文件是 SAAS 版而不是单商户版两者表结构差异巨大。导入完成后看下日志有没有报错很多压缩包里的 SQL 是用旧 MySQL 导出的在 MySQL 8 下会因为 sql_mode 严格模式报语法错遇到就把 sql_mode 改宽松再导一次。2.4 跑通后台和控制台先创建一个最小站点再谈其他数据库就绪后配置数据库连接。Niushop 一般会在 application 的 config 目录下放 .php 配置文件你只需要把 host、库名、用户名、密码填对。填完后访问 http://你的域名/public/index.php 看到商城首页再访问 admin 入口进入管理后台用源码说明里的默认管理员账号登录。我习惯登录后台后先做三件事改管理员密码、关闭安装目录、创建第一个 SAAS 站点。不关闭 install 目录的话任何人重新访问安装向导都有重置系统的风险这属于上线前最基础的安全动作。创建站点时注意选择「小程序端」和「公众号端」都开启很多功能在换端后要重新配置漏配的话后面小程序里会看不到任何商品。验证跑通的标准不是首页能打开而是后台能新建一个商品并上架这才说明数据库读写、文件上传、模板编译都没问题。3. 小程序端对接微信从后台配置到开发者工具跑通首页3.1 小程序端源码的两种拿法uniapp 工程和编译产物Niushop 的 SAAS 版小程序端在源码里通常以 uniapp 工程形式提供也有的包直接给编译好的微信小程序产物。两者的区别决定了你后续改起来费不费力。uniapp 工程让你用 Vue 语法开发能同时编译到微信小程序、H5、App适合想长期维护并把商城扩展到抖音、支付宝端的人编译产物是 wxml/wxss/js 文件包可以直接放到微信开发者工具里预览但改起来别扭每个页面要改三处文件。项目标题既然强调小程序我就按「先跑通编译产物、再回 uniapp 改逻辑」的顺序讲。打开源码目录找到小程序的工程文件夹比如叫 uniapp 或 shopwap 的目录。用微信开发者工具导入时直接导入编译好的小程序目录而不是 uniapp 根目录。这里有个翻车率很高的细节开发者工具导入 uniapp 根目录会提示找不到 app.json因为根目录只有源码没有构建产物。你必须在 uniapp 工程里执行一次构建# 在 uniapp 工程目录下安装依赖并编译到微信小程序 cd /var/www/niushop/uniapp # 实际目录名以源码为准 npm install # 构建微信小程序产物 npm run build:mp-weixin构建完成后产物在 dist/build/mp-weixin 目录下把这一整个目录用开发者工具「导入项目」打开。要注意 package.json 里 scripts 的构建命令名称可能不是 build:mp-weixin先查看 package.json 再执行不要复制命令盲跑。3.2 用后台把小程序「钥匙」配齐AppID、AppSecret、URL 白名单小程序能请求商城接口之前后台和小程序两端要做对称配置。Niushop 后台的「小程序设置」里一般要求填 AppID、AppSecret、商户号等。你不能只在微信公众平台拿到 AppID 就开干那是只配了一半。先登录微信公众平台在小程序账号的「开发管理-开发设置」里拿到 AppID 和 AppSecret再配置服务器域名request 合法域名填你的商城接口域名例如 https://shop.example.comuploadFile 合法域名图片上传接口的域名downloadFile 合法域名商品图片、文件下载接口的域名这三项不配小程序真机预览时所有请求都会报「url not in domain list」开发者工具里提醒你勾选「不校验合法域名」才能只在本地绕过。很多新手直接勾了不校验却忘了上线前一定要把域名配好最后审核时被打回。配好后台的 AppID 和 AppSecret 后保存并重启一下缓存否则小程序登录时拿不到 openid。3.3 开发者工具跑通首页三处必须手动改的位置用开发者工具打开编译产物后你第一眼看到的页面大概率是白屏或请求失败。不要急着怀疑源码先检查三处一项目根目录下的 utils/config.js 或 request.js 里配置的接口请求地址很多模板默认写的是 http://localhost:8080 或某官网你必须改成自己的商城域名二manifest.json 里的小程序 AppID 是否已替换成你自己的三微信开发者工具详情里是否勾选了 ES6 转 ES5。我见过不少人改了后台、改了域名唯独忘了改前端打包时写死的 baseUrl结果首页白屏半天。// utils/config.js 中常见的配置位置按实际文件调整 const CONFIG { // 改成你的商城接口域名注意只能是 HTTPS且已在公众平台配置过域名白名单 baseUrl: https://shop.example.com, // 图片资源地址通常和接口同源 imgUrl: https://shop.example.com/upload, // 小程序 AppID在公众平台复制 appId: wx1234567890abcdef }; module.exports CONFIG;参数说明baseUrl 是所有商品列表、订单提交、登录请求的公共前缀路径写错会出现「有的页面能开、有的页面报错」的诡异情况因为不同接口可能拼接了不同路径imgUrl 如果只配了接口域名没配图片域名商品图会裂成一片灰块后台能看、小程序看不到这种情况十有八九是这里漏了。改完后清缓存重新编译。3.4 让页面标题不再是死标题动态设置小程序头部标题商城小程序有个高频需求不同店铺、不同商品分类头部标题跟着变。Niushop 的页面标题如果写死在 pages.json 里就会出现所有店铺共用一套标题的尴尬。微信小程序原生支持通过 wx.setNavigationBarTitle 在运行时改标题uniapp 工程里对应 uni.setNavigationBarTitle。常见做法是在店铺详情页的 onLoad 里读取店铺名称后设置// 页面加载时根据店铺信息动态设置头部标题 onLoad(options) { // options 里通常是路由带过来的店铺参数 const shopId options.shop_id; this.getShopInfo(shopId, (shop) { uni.setNavigationBarTitle({ title: shop.shop_name }); }); }这个改动很小但客户感知很强。Niushop 这类商城源码默认标题往往是平台名商户入驻后会要求「我的店铺名显示在小程序头部」你二开时优先用这个方案不要改 pages.json 里的全局标题因为微信小程序页面配置的静态标题只在首次渲染时生效动态修改必须在页面生命周期里触发。4. 搞懂 SAAS 版的多站点逻辑商户、门店、套餐和数据边界4.1 站点、商户、门店Niushop SAAS 版的三级组织Niushop 开源商城小程序 SAAS 版跟普通单商户源码最大的区别不在前端而在后台的数据组织方式。单商户系统里一个后台管一个店SAAS 版里平台运营者先建「站点」站点是独立的商城实例一个站点可以是一个入驻商户也可以是一个品牌连锁。站点下面再挂门店门店对应线下实体位置小程序端往往通过定位或店铺列表展示就近门店。理解这套结构对你的二开很重要写商品模块时要区分「这个商品属于哪个站点」会员登录要区分「这个用户是从哪个站点注册来的」订单结算时要判断「这个订单属于哪个门店的库存」。我在做二开时最怕业务方说「我只要加一个字段」没弄清表里有 site_id、shop_id、store_id 三层归属改一处报表就会串数据。4.2 套餐其实是一个功能开关集合不是费用中心标题里强调 SAAS 版而 SAAS 的核心运营动作是卖套餐。Niushop 后台应该有一个套餐/应用管理模块本质上是功能开关的集合基础套餐开商品和订单进阶套餐开营销插件高级套餐开门店和店员管理。你给商户开套餐时数据库里记录的不是金额而是一组权限点。搞清楚这个逻辑对二次开发很关键——不要试图在套餐表里存价格和时长之外的东西真正的配置在权限映射表里。热词里提到「saas套餐的费用策略」这里给一个实战建议平台方做费用策略时不要按「功能数」定价要按「GMV 和门店数」分层Niushop 的套餐机制更适合做门店数限制而不是功能硬切因为功能开关切多了前端页面会因为缺组件而直接报错商户会以为是系统坏了。免费套餐建议只给基础商品和订单付费套餐放开营销和门店管理。4.3 数据隔离不是靠数据库分库而是靠 site_id很多做传统软件的人一听 SAAS 就以为要让每个商户一个数据库。Niushop 这种开源实现不是这么做的它使用公共库 site_id 字段隔离数据。所有商户的商品、订单、会员都混在同一张表里靠查询条件里的 site_id 区分。这个方案节省资源但埋了一个坑你写 SQL 统计报表或做跨商户功能时自带一个不留神忘了加 site_id就会把全平台的数据全部捞出来。以下是一条很典型的安全写法-- 错误示范统计某商户订单时漏掉 site_id会把全平台订单都算进来 SELECT COUNT(*) FROM orders WHERE shop_id 5; -- 正确示范SAAS 环境查询必须带站点维度 SELECT COUNT(*) FROM orders WHERE site_id 1 AND shop_id 5;注意site_id 是平台站点维度shop_id 是商户维度两个字段都要用上。Niushop 的后台框架一般会提供带 site_id 的数据层方法你直接用框架模型就有隔离但如果你写原生 SQL 查询就绕过了框架保护必须自己补条件。这是 SAAS 二开最容易出安全事故的地方没有之一。4.4 单商户多门店和 SAAS 版怎么选热词里「niushop单商户v5多门店」和标题里的「SAAS版」经常让人犹豫。我的判断标准很简单如果只是想让一个品牌总店管理多个分店用户不区分入驻关系用单商户多门店版本更合适菜单和权限模型简单部署成本低如果你想做成一个平台让不同商家交钱入驻、各自管理自己的商品和订单再考虑 SAAS 版。标题既然写的是 SAAS 版那你就要接受它的管理后台是「平台后台 商户后台」两套的复杂度而不是一套后台走天下。部署 SAAS 版时要注意商户后台入口往往和平台后台不同常见的是在同一个后台里切换身份或者通过站点域名访问商户端。如果只配了平台域名商户会打不开自己的店铺管理页面。我习惯在部署时第 2 个域名指向同一个入口再让商家通过这个域名登录而不是让商家直接访问总后台。5. Niushop 部署与二开避坑五个容易让人翻车的点5.1 后台能进、小程序首页 404先查伪静态别改代码现象后台和商城 PC 端都正常小程序首页一打开不是白屏而是 404。原因小程序端访问的接口路径依赖 Nginx 伪静态规则很多环境只配置了入口却没配置 rewrite。Nginx 会把你指到不存在的文件路径上自然 404。解决在 Nginx 站点配置里添加 Niushop 常用的伪静态规则规则一般在源码包的 nginx.conf 或文档里能找到找不到就用通用 PHP 伪静态location / { try_files $uri $uri/ /index.php?$query_string; } location ~ \.php$ { include snippets/fastcgi-php.conf; fastcgi_pass unix:/run/php/php7.4-fpm.sock; }加了规则后 reload Nginx再回开发者工具重试。记住小程序端 404 优先怀疑路由层不要一头扎进前端代码里找原因。5.2 支付回调不通HTTPS、回调地址和微信支付商户号三连查现象用户在小程序里能下单但支付成功后订单状态一直是「待付款」后台看不到支付回调日志。原因Niushop 的支付回调地址要求公网 HTTPS 访问微信支付在回调时如果证书校验失败或回调地址不可达会静默重试数次后放弃。最常见原因是支付配置时把回调地址写成了 http或者把 IP 写成了 localhost。解决先后台支付设置里把回调地址改成生产环境 HTTPS 域名再到微信支付商户平台确认 APIv3 密钥和证书序列号已更新。我踩过一次很深的坑Niushop 新旧版本支付回调路径不一样升级后旧回调路径变 404支付就永远回不来最后对照源码里的路由文件把新回调地址填进商户平台才解决。5.3 「开发版小程序已过期请在开发者工具重新扫码」现象开发者工具和真机预览都提示开发版已过期点开小程序直接弹过期提示。原因微信开发者工具的临时调试权限默认有时效代码包上传到微信后台后会生成开发版超过有效期就失效。开发者工具本地预览时已授权的登录态过期同样会弹这个提示。这和 Niushop 源码没有关系是微信平台侧的机制。解决重新在开发者工具里点「清缓存-清除全部缓存」然后点「重新扫码登录」如果还是在真机上过期就重新上传体验版在微信公众平台把体验版重新设为「体验版」再扫码。不要反复点编译编译解决不了授权过期这是腾讯的会话机制。5.4 站点数据串了A 商户看到 B 商户的商品现象商户 A 登录后商品列表里出现商户 B 的商品点击编辑还报无权操作。原因这类问题 90% 出现在缓存。Niushop 的 SAAS 版在 Redis 或文件缓存里把商品列表缓存成 key如果缓存 key 没有包含 site_id站点间数据就会串。很多新手在二开后引入手动查缓存的方法只查了表没查缓存。解决清掉 runtime 目录里的缓存并检查缓存 key 规则。我一般会在商品查询方法的缓存 key 里强制拼上 site_id// 商品列表缓存的 key 必须包含站点 ID $cacheKey niushop_goods_list_ . $site_id . _ . $page; $list cache($cacheKey); if (!$list) { $list (new Goods())-where(site_id, $site_id)-select(); cache($cacheKey, $list); }关键点不只是查询要加 site_id缓存 key 也要加 site_id这是 SAAS 开发最容易漏的细节。我在做多站点商城时一律禁止写不带 site_id 的缓存 key代码 review 时会重点盯这个位置。5.5 改了 uniapp 前端样式小程序端不生效现象在 uniapp 的 vue 文件里改了背景色、按钮样式开发者工具里完全没变化。原因开发者工具加载的仍然是 dist 目录的老编译产物不是源码。改 uniapp 工程里的代码不会自动同步到 dist需要重新构建更坑的是某些老版本 uniapp 对 CSS 修改不触发增量编译构建出来还是旧样式。解决手动执行一次完整构建并强制清掉 dist 目录cd /var/www/niushop/uniapp # 删除旧的编译产物避免增量编译残留 rm -rf dist/build/mp-weixin # 重新完整构建 npm run build:mp-weixin构建完后再回开发者工具点编译。如果你的 Niushop 前端不是 uniapp 而是原生小程序目录那不存在这个区别但很多新版 SAAS 版已经转向 uniapp所以这里单独列出来。6. 不只是能跑上线前把 HTTPS、备份和消息推送验一遍6.1 HTTPS 不只是为了锁头图标Niushop 的微信登录靠它微信公众平台的合法域名强制要求 HTTPS你本地开发者工具能走 http是因为勾了「不校验合法域名」。一上线http 链接的请求全部被微信拦截支付回调、二维码生成、分享卡片都会失效。用 certbot 一把梭sudo apt install -y certbot python3-certbot-nginx sudo certbot --nginx -d shop.example.com证书签完重启 Nginx再去开发者工具里取消「不校验合法域名」真机预览一轮商品列表、加购、支付流程这一步能提前暴露大多数 SSL 证书链问题。常见翻车点是证书签了但前端代码里的 baseUrl 仍是 http所以第 3 章里那个配置文件要一起改。6.2 数据库备份上线前至少做一次全量并恢复验证很多团队备份是「mysqldump 到服务器本地」服务器被入侵或磁盘坏了备份一起消失等于没备份。我现在的习惯是本地全量 异地增量Niushop 的表量不大全量备份每天一次足够# 每天晚上 2 点执行保留最近 7 天 mysqldump -uniushop -p密码 niushop_saas --single-transaction \ | gzip /backup/niushop_$(date \%F).sql.gz # 删除 7 天前的备份文件 find /backup -name niushop_*.sql.gz -mtime 7 -delete注意 --single-transaction 参数商城的订单表在备份期间可能还在写入不加这个参数会出现备份文件不一致恢复后订单数据对不上账。每个星期抽一次备份恢复到测试库我吃过「备份执行成功但恢复报错」的亏所以恢复演练比备份本身更重要。6.3 消息推送验证别等用户投诉了才发现模板消息没配Niushop 商城小程序依赖微信订阅消息来通知订单支付成功、发货、发货提醒。你可能在后台配置了模板 ID但没测试就上线结果用户下单后完全收不到通知。模板消息的坑有两个一是订阅消息需要用户在小程序里主动授权代码里要有触发订阅的按钮二是后台填的模板 ID 要与小程序后台开通的模板对应一个字符不对都会推送失败。上线验证路径用测试账号下单 → 支付 → 后台发货 → 用收货手机号登录小程序看是否收到两条订阅消息。如果收不到去 Niushop 后台的日志目录看推送记录微信 API 会返回错误码最常见的是 template ID 无效和用户未授权前者回小程序后台核对模板后者检查代码里 uni.requestSubscribeMessage 是否已调用。做商城小程序这几年我最大的教训从来不是框架选型而是「能跑」和「能上线」中间隔着 HTTPS、备份、消息推送这些脏活。先把这些做扎实再用 Niushop 去谈商户入驻、谈套餐分成才睡得着觉。希望帮到你。本文还有配套的精品资源点击获取