点微同城30.0全套插件拆解：47个插件部署与避坑指南

简介：这份资源是 discuz 点微同城 30.0 全套插件压缩包，面向搭建本地生活服务平台的站长、开发者与运营团队，覆盖同城分类信息、好店、招聘、房产、婚恋、拼团、抢购、抽奖、拼车、相亲、交友、电话本、签到、红包、子站点等二十余个业务模块，并附带 H5 与小程序前端，可帮助读者一次性补齐同城系统的功能矩阵，省去逐个寻找插件的成本。压缩包为 zip 格式，整体约 72.53MB，内含 47 个插件，涵盖同城教育培训、预约、疫情地图、招聘 PC 版、房产、婚恋、拼团、优惠抢购、到家、抽奖等具体组件，各插件按业务线独立封装，便于按需启用与后期升级。目前已有 679 人浏览学习，适合具备 discuz 二次开发基础、需要快速验证同城平台功能或做功能对照参考的读者。需注意资源不提供技术支持，下载后需自行承担使用风险。

1. 点微同城 30.0 全套插件拆解：47 个插件到底在解决什么问题

如果你正在用 Discuz 做本地生活门户，或者接过「同城信息 + 分类信息 + 商家黄页」这类需求，那点微同城这套东西大概率绕不开。它本质上是 Discuz 的一个插件矩阵，30.0 版本把 47 个功能插件打包在一起，覆盖了分类信息发布、商家入驻、同城圈子、H5 端和微信小程序端。标题里那个.zip不是单一插件，而是一整套前后端工程加配置文件的集合，H5 和小程序前端是独立目录，后端逻辑挂在 Discuz 的插件体系上。

它解决的问题很具体：让你不用从零写一套同城系统，直接基于 Discuz 的用户体系和内容模型，快速搭出一个能发帖、能分类、能对接微信生态的同城平台。适合谁？适合手里已经有 Discuz 站点、想加同城模块的站长，也适合接私活需要快速交付本地门户的开发者。但别指望解压就能跑，47 个插件之间的依赖关系、H5 与小程序端的接口对齐、Discuz 版本兼容性，都是要动手调的。下面按「先看懂结构、再动手部署、最后避坑」的顺序拆。

2. 47 个插件不是平铺的：先搞清点微同城的目录分层与依赖关系

拿到压缩包先别急着往服务器传。点微同城 30.0 的插件不是 47 个独立文件夹随便堆在一起，它们按功能域分成了几个层次，层与层之间有调用关系。搞不清这个，后面装到一半发现某个插件报「缺少依赖」就抓瞎了。

2.1 从压缩包目录看插件分类逻辑

解压后典型的结构是这样（不同分发版本可能有细微差异，但分层逻辑一致）：

dianwei_tongcheng_30/ ├── discuz_plugin/ # Discuz 插件目录，按插件标识分文件夹 │ ├── dianwei_core/ # 核心框架插件，其他插件依赖它 │ ├── dianwei_category/ # 分类信息主插件 │ ├── dianwei_shop/ # 商家入驻与店铺 │ ├── dianwei_circle/ # 同城圈子 │ ├── dianwei_pay/ # 支付与订单 │ └── ... # 其余按功能命名 ├── h5_frontend/ # H5 前端工程，通常是 Vue 或 uni-app 构建 ├── miniprogram_frontend/ # 微信小程序前端工程 ├── install/ # 安装引导与 SQL 文件 └── docs/ # 配置说明与接口文档

核心是dianwei_core，它提供公共的模型、路由、权限校验和 API 基类。分类、商家、圈子这些插件都继承它的基类。如果你只装分类插件不装 core，页面能打开但数据读写会直接报错。常见做法是先把 core 装好并确认 Discuz 后台插件列表里它显示「已启用」，再逐个装业务插件。

2.2 后端插件与前端工程的接口对齐方式

H5 和小程序前端不直接读 Discuz 的 PHP 模板，它们走的是插件暴露的 API。点微同城一般会在 core 里注册一组 RESTful 路由，比如/api/tongcheng/category/list、/api/tongcheng/shop/apply。前端工程里会有一个config.js或.env文件配baseURL，指向你 Discuz 站点的域名加 API 前缀。

这里有个容易翻车的点：H5 和小程序用的接口路径可能不完全一样。小程序端因为要过微信的域名校验，有时会走一个单独的miniprogram_api入口，需要在 Discuz 里额外配置。对齐方法是打开前端工程的request封装文件，看它拼接的完整 URL，再对照后端插件的路由注册代码，确认路径、请求方法、参数名三者一致。不一致就改前端配置，别去动后端路由，后端一改可能影响其他插件。

2.3 安装前必须确认的 Discuz 版本与 PHP 环境

点微同城 30.0 对 Discuz 版本有要求，常见是 Discuz X3.4 或 X3.5，PHP 版本一般要求 7.2 到 7.4 之间。PHP 8 以上很多老插件会报废弃警告甚至致命错误。装之前先在 Discuz 后台看「系统信息」，确认版本号，再建一个phpinfo.php看 PHP 版本和已装扩展。

必须开的扩展：pdo_mysql、curl、json、mbstring、gd。curl用于小程序端调用微信接口，gd用于图片验证码和缩略图。如果curl没开，商家入驻提交时会卡在「正在验证」然后超时。数据库建议 MySQL 5.7 或 8.0，字符集用utf8mb4，否则同城圈子里的 emoji 会存成问号。

提示：装之前把 Discuz 的config/config_global.php和数据库先备份一份。插件安装会往common_plugin等表写数据，装错了回滚很麻烦。

3. 从零部署一套可访问的同城站点：后端插件安装与 H5 前端跑通

这一章是动手部分。目标是在本地或测试服务器上，让 Discuz 后台能管理同城插件，H5 前端能打开并拉到分类数据。小程序端因为涉及微信开发者工具和 AppID，放到下一章单独说。

3.1 上传插件并执行安装 SQL 的完整命令

先把discuz_plugin下的插件文件夹传到 Discuz 根目录的source/plugin/下。假设 Discuz 装在/var/www/discuz，用 scp 或宝塔面板上传都行。传完后目录结构应该是/var/www/discuz/source/plugin/dianwei_core/这样。

然后处理install/里的 SQL。点微同城的安装 SQL 通常按插件分文件，比如install_core.sql、install_category.sql。不要一次性全部导入，按依赖顺序来。用命令行导入：

# 进入 Discuz 根目录，确认数据库连接信息在 config/config_global.php 里 cd /var/www/discuz # 先导入核心表，-u 和 -p 换成你的数据库账号 mysql -u discuz_user -p discuz_db < install/install_core.sql # 再导入分类插件表 mysql -u discuz_user -p discuz_db < install/install_category.sql # 导入后检查表是否创建成功，表前缀默认是 pre_ mysql -u discuz_user -p discuz_db -e "SHOW TABLES LIKE 'pre_dianwei%';"

逻辑说明：install_core.sql建的是公共表，比如插件配置表、API 日志表；install_category.sql建分类和内容表，外键关联 core 的表。如果先导分类后导核心，外键约束会报错。参数上，discuz_user和discuz_db换成你实际的，表前缀pre_要和 Discuz 配置一致，不一致就全局替换 SQL 文件里的前缀再导入。

导入完成后进 Discuz 后台「应用」→「插件」，应该能看到点微同城的插件列表。逐个点「安装」，安装时如果提示「数据表已存在」，说明 SQL 已经手动导过了，选「跳过」或「覆盖」都行，但覆盖会清空已有数据，测试阶段无所谓，生产环境要小心。

3.2 H5 前端工程的依赖安装与接口地址配置

H5 前端一般是 Vue 2 或 uni-app 工程。进h5_frontend目录，先看package.json里的依赖和脚本。常见命令：

cd h5_frontend # 安装依赖，如果 npm 慢可以用 cnpm 或配淘宝源 npm install # 开发模式启动，端口通常在 config 里配，默认可能是 8080 npm run serve # 生产构建，产物在 dist 目录 npm run build

启动前必须改接口地址。找src/config/index.js或.env.development，把BASE_URL改成你的 Discuz 域名加 API 前缀，比如http://test.yoursite.com/api/tongcheng/。改完重启 dev server。打开浏览器访问http://localhost:8080，如果首页能加载出分类列表，说明前后端通了。如果控制台报 404，看 Network 里请求的完整 URL，和后端路由对比，多半是前缀少了或多了斜杠。

生产构建后把dist里的文件传到 Discuz 某个目录下，比如/var/www/discuz/tongcheng_h5/，然后配 Nginx 或 Apache 的伪静态，让 H5 的路由能正确回退到index.html。Nginx 配置片段：

location /tongcheng_h5/ { alias /var/www/discuz/tongcheng_h5/; index index.html; try_files $uri $uri/ /tongcheng_h5/index.html; }

try_files那行是关键，不加的话刷新页面会 404。alias路径末尾的斜杠要和location匹配，不然会拼出双斜杠。

3.3 后台配置同城参数：分类、地区与权限

插件装好、前端能跑之后，进 Discuz 后台点微同城的设置页。要配的东西不少，按优先级来：

第一，地区库。同城系统靠地区做筛选，点微同城一般自带一份省市区数据，但可能需要你手动导入或同步。在「地区管理」里确认数据完整，缺的可以手动加。

第二，分类结构。分类支持多级，建议先规划好一级分类（比如「房产」「招聘」「二手」），再往下加二级。分类的fid和前端路由参数对应，改分类后前端可能要重新构建才能生效。

第三，用户组权限。哪些用户组能发布、能审核、能置顶，都在权限设置里。默认可能只有管理员能发，测试时记得给自己所在的用户组开权限，否则前端发帖按钮点了没反应。

第四，API 密钥。如果小程序端要调用，这里会生成一个appid和secret，记下来，小程序配置里要用。

注意：改完后台配置后，Discuz 的缓存要更新。后台「工具」→「更新缓存」，勾选「插件缓存」和「DIY 模块缓存」，不更新的话前端拿到的还是旧配置。

4. 小程序端对接与 H5 差异：登录、手机号与域名校验

小程序端不是 H5 的简单套壳。微信生态有自己的登录态、手机号获取和域名白名单机制，点微同城的小程序前端工程里已经封装了这些逻辑，但配置不对就卡在登录页。

4.1 微信小程序登录与手机号获取的配置链路

小程序登录流程是：前端调wx.login拿code，传给后端，后端用code加appid、secret调微信接口换openid和session_key。点微同城的 core 插件里一般有处理这个的控制器，路径类似/api/tongcheng/miniprogram/login。

你要做的是在miniprogram_frontend的配置文件里填对appid。找project.config.json或app.js里的全局配置，把appid换成你自己小程序的。后端那边，在点微同城设置里填secret。两边不一致，登录就报invalid appid。

手机号获取需要小程序有「获取手机号」的权限，且用户主动点击按钮。前端调wx.getPhoneNumber拿到加密数据，传给后端解密。后端解密依赖session_key，所以登录和获取手机号必须按顺序来，先登录再获取。常见翻车是用户没登录就点获取手机号，后端拿不到session_key，解密失败。

4.2 H5 与小程序端接口差异对照表

这张表是排查接口问题的底稿。前端报错先看请求路径落在哪一列，再对照后端路由文件确认有没有注册。小程序端所有请求域名必须在微信后台「开发设置」→「服务器域名」里配好，request合法域名、uploadFile合法域名、downloadFile合法域名都要加。少配一个，对应功能就静默失败，控制台可能只报一个笼统的request:fail。

4.3 用开发者工具跑通小程序并预览真机

装微信开发者工具，导入miniprogram_frontend目录。工具会读project.config.json里的appid，如果这个appid不是你自己的，会提示无权限。改成自己的，或者用测试号。

导入后点「编译」，模拟器里应该能出首页。如果白屏，看调试器的 Console 和 Network。常见问题是BASE_URL没改，请求发到了示例域名。改app.js或config.js里的接口地址，重新编译。

真机预览点「预览」，用微信扫码。真机上如果接口请求失败，先确认手机网络能访问你的服务器，再确认域名是 HTTPS 且证书有效。微信小程序要求所有请求走 HTTPS，自签名证书不行。测试阶段可以在开发者工具里勾「不校验合法域名」，但真机预览这个选项不生效，必须配好域名。

提示：小程序端的图片上传路径和 H5 不同，H5 用FormData，小程序用wx.uploadFile。后端要同时兼容这两种接收方式，点微同城的 core 里一般做了兼容，但如果自己改了上传逻辑，记得两边都测。

5. 避坑与排查：47 个插件混装时最容易翻车的 5 个点

这套东西插件多、依赖杂，装的过程中踩坑是常态。下面 5 条是血泪经验里频率最高的，每条按「现象 → 原因 → 解决」写。

现象一：后台插件列表里点微同城插件显示「已安装」但前台页面 404。原因：Discuz 的插件启用状态和伪静态规则没对上。插件启用了，但访问路径被 Discuz 的默认路由拦截，没走到插件的入口文件。 解决：检查 Discuz 后台「全局」→「SEO 设置」→「URL 静态化」，确认插件相关的伪静态规则已添加。如果用的是 Nginx，看rewrite规则里有没有插件标识。实在不行，先用plugin.php?id=dianwei_core:index这种动态 URL 访问，能通说明插件本身没问题，再调伪静态。

现象二：H5 前端分类列表能加载，但点进详情页空白。原因：详情页接口返回的数据结构和前端模板不匹配。常见是后端返回的字段名是content，前端读的是detail，或者图片字段后端给的是相对路径，前端当绝对路径用。 解决：打开浏览器 Network，看详情接口的原始响应，和前端detail.vue里绑定的字段逐个对比。字段名不一致就改前端，路径问题在后端返回时拼上完整域名，或者前端加baseURL前缀。

现象三：小程序端登录一直转圈，最后提示「网络异常」。原因：appid或secret配错，或者服务器时间不同步导致微信接口签名校验失败。 解决：先确认appid和secret是同一套，且小程序后台的「开发设置」里没有重置过secret。再检查服务器时间，date命令看和标准时间差多少，差超过几分钟就同步一下。微信接口对时间戳敏感，偏差大了直接拒绝。

现象四：商家入驻提交后，后台看不到待审核数据。原因：数据写进了表，但审核列表的查询条件过滤掉了。常见是状态字段默认值不对，比如插入时status是0，但审核列表只查status=1的。 解决：直接进数据库看pre_dianwei_shop表（表名以实际为准），看刚提交的数据status字段值。再对照审核控制器的查询条件，改前端提交时的默认状态，或改后端查询条件。别直接改数据库，下次提交还是错的。

现象五：更新 Discuz 缓存后，同城页面样式错乱。原因：插件更新时覆盖了 Discuz 的公共 CSS 或 JS，或者缓存更新把插件的静态资源路径改了。 解决：先看浏览器 Console 有没有 404 的资源，找到缺失的文件路径，对比插件目录里的实际路径。如果是缓存导致的，后台「工具」→「更新缓存」时只勾「插件缓存」，别勾「模板缓存」，模板缓存更新可能重置 DIY 模块。样式问题多半是 CSS 文件被合并或压缩后路径变了，检查 Discuz 的data/cache目录下插件相关的缓存文件。

6. 让同城站点跑得更稳：接口调试、数据备份与版本升级的实操习惯

部署完只是开始，后面日常维护才是真正花时间的地方。分享几个我反复用到的技巧，都是踩过坑之后留下来的习惯。

接口调试用 Charles 抓小程序请求。小程序在开发者工具里能看到 Network，但真机上的请求有时候工具抓不到。用 Charles 配代理，手机连上后可以看小程序实际发出的请求和响应。重点看请求头里的Referer和User-Agent，有些后端逻辑会根据这些做校验。Charles 的Map Local功能还能把线上接口映射到本地文件，方便改响应数据测前端边界情况，不用每次都改后端。

数据库备份按插件分表导。点微同城的表前缀统一，但不同插件的表可以分开导。比如只升级分类插件时，只备份pre_dianwei_category%相关的表，不用全库导。命令：

# 只导出分类插件相关的表，-t 指定表名模式 mysqldump -u discuz_user -p discuz_db $(mysql -u discuz_user -p discuz_db -N -e "SHOW TABLES LIKE 'pre_dianwei_category%'" | tr '\n' ' ') > category_backup.sql

这条命令先查出所有匹配的表名，再传给mysqldump。恢复时直接mysql -u user -p db < category_backup.sql。比全库备份快，回滚也精准。

版本升级先看 SQL 变更。点微同城从 30.0 升到更高版本时，install/目录里会有upgrade_xxx.sql。升级前先看这些 SQL 改了哪些表结构，有没有DROP或ALTER操作。有DROP的，先备份对应表。升级顺序一般是先导 SQL，再覆盖插件文件，最后更新缓存。顺序反了，新代码读旧表结构会报字段不存在。

给 API 加一层日志。点微同城的 core 里一般有日志开关，在后台设置里打开。日志会记录每个 API 请求的入参、出参和耗时。前端报错时先看日志，能快速定位是参数没传对还是后端逻辑出错。日志量大的话按天清理，别把数据库撑爆。

最后一条习惯：改任何配置前先记下原值。不管是后台的设置项还是配置文件里的参数，改之前截个图或复制一份。同城系统配置项多，改了一个忘了原来是什么，回滚时只能重装。这个习惯帮我省过至少两次重装的时间。

希望帮到你。

本文还有配套的精品资源，点击获取