简介面向停车场运营方、系统集成商及Java后端开发者这份停车场系统源码提供完整的H5小程序前后端实现兼容主流相机并支持云端计费、预约车位、移动缴费等核心场景。技术栈覆盖Spring Boot 2、Dubbo、MySQL/MongoDB/Redis、Netty 4及原生安卓/iOS端后台管理基于vue-typescript-admin-template并附带数据库初始化SQL与部署说明便于二次开发与生产落地。压缩包共1239个文件以Java源码、class字节码、XML配置、properties/yml配置文件及Vue/小程序前端代码为主整体仅8.46MB目录层次清晰可快速定位后端服务、管理后台和H5端模块。已有1422人学习下载适合需要评估代码结构或基于开源架构搭建停车平台的开发者参考。1. 停车场系统源码拿到手别急着部署一套「停车场系统源码 停车场小程序源码 前后端 部署说明」的压缩包听起来东西很全但大多数第一次接触这类源码的人卡住的地方根本不是代码而是小程序平台侧的规则域名必须是 HTTPS、接口域名要在后台白名单里、支付要走商户号。这些限制不在源码里却在部署说明里经常被一笔带过。这套系统解决的是典型的停车业务闭环车辆入场识别、车位占用管理、按时计费、出场结算以及车主在小程序端查车牌、缴停车费、开电子发票。适合接外包想快速出活的团队、给存量停车场做智能改造的实施方以及想拿完整全栈项目练手的人。我的建议是先花半小时确认技术栈和目录结构再决定本地跑还是直接上服务器这比蒙头部署省时间得多。2. 先看架构再动手一辆车从入场到缴费经历了什么2.1 一套源码里的三个端各自负责什么这类停车场系统源码普遍是三个客户端加一个服务端的结构。管理后台PC 端给车场管理员用负责设置车场信息、收费标准、月卡用户、查看场内车辆列表和出入场记录小程序端给车主用提供车牌绑定、停车状态查询、一键缴费、订单记录和发票申请入口服务端是核心承接两端的接口请求同时对接车牌识别相机、道闸控制器和支付通道。服务端通常还会带一个定时任务模块处理超时订单、离线计费补算这类后台逻辑。理解业务链路比读代码更重要。一辆车进场的完整链路是这样的相机识别到车牌后把车牌号通过 HTTP 回调或私有协议推给服务端服务端生成一条入场记录并把车位状态置为占用同时通知道闸开闸放行车主在离场前打开小程序输入或选择自己的车牌服务端根据入场时间算出应收金额车主完成支付后服务端调道闸接口再次开闸并更新订单状态。任何一端出了问题这条链路都会断排查的时候按这个顺序走基本不会错。我自己判断一套源码质量的方法很简单先看它有没有把「入场—计费—支付—出场」这条主链路完整串起来再看它有没有把异常情况考虑进去比如没识别到车牌怎么处理、断网时车辆已经出场了怎么补单。很多开源或外包源码只做了主流程边界情况全是空的这类代码接手后工作量反而更大。所以拿到源码后不要急着启动先按这条链路去代码里找对应的接口和表结构。2.2 从目录结构快速判断技术栈和项目健康度解压源码后第一件事看根目录。命名规范的项目根目录下会清楚区分 admin管理后台、server服务端、miniprogram 或 uni-app小程序端、doc部署说明和数据库脚本。如果所有文件混在一个目录里连个 README 都没有这类源码的维护成本通常会比较高但也不代表不能用只是你得多花时间梳理。我遇到过某个模拟项目 X 的源码压缩包 2 个多 G解压后光 node_modules 就占了一大半真正的业务代码其实不到 50 MB这种就要小心目录里是不是混入了不该提交的东西。# 用 tree 命令快速看目录层级不要用图形界面一个个点 tree -L 2 -d # 输出大致会长这样 # ├── admin # 管理后台前端 # │ └── src # ├── server # 服务端 # │ ├── src # │ └── sql # 数据库初始化脚本 # ├── miniprogram # 小程序端 # │ ├── pages # │ └── utils # └── doc # 部署说明与接口文档这一步的主要目的是判断技术栈。服务端是 Java 就会看到 pom.xml 或 build.gradle是 Node.js 就会看到 package.json是 PHP 就会有 composer.json 或 thinkphp 目录。管理后台和小程序端也同理小程序端如果根目录有 manifest.json 就是 uni-app 写的跨端框架没有的话大概率是原生微信小程序。技术栈没有绝对好坏但你得确认自己团队能维护我经手过的某外包项目就是用了一个冷门框架接手方连编译命令都找不到最后被迫重写这个成本比改业务代码高得多。2.3 车牌识别相机和道闸是绕不开的硬件对接纯软件源码跑通很容易真正让停车场系统落地的难点在硬件对接。市面上停车场用的车牌识别相机主流对接方式是 HTTP 回调相机拍到车牌后往服务端配置好的 URL 上推送一条 JSON 数据里面带车牌号、识别图片地址、设备编号、时间戳。服务端收到后做入场或出场逻辑。这种方案最简单也是多数源码默认支持的。另一类是私有 SDK相机厂商提供动态库或二次开发包服务端去主动拉取识别结果这种耦合就深了换相机品牌基本等于改一套接口。道闸的控制更直接常见做法是服务端调一个开闸 URL带设备 ID 和动作参数也有通过继电器和串口控制的后者在小程序系统里很少见。部署时最关键的是网络连通性。相机要能访问到服务端的接口地址反之服务端要能访问到道闸的控制器 IP。很多现场问题都是网络策略导致的相机和服务器不在同一个网段路由没放通或者道闸控制器在摄像头所在的内网服务器在云端结果云端服务端根本调不到道闸。所以在本地开发阶段我一般会用一个相机模拟器先验证主流程等到了现场再把真实设备接进来缩小排查范围。模拟器网上有很多开源实现向服务端定时推送模拟车牌数据足以跑通入场、计费、出场、支付整条链路。下面是这类系统硬件对接时最常用的几个参数实际部署按现场设备改就行对接对象常见方式关键参数故障高发点车牌识别相机HTTP 回调推送识别结果 URL、设备编号、图片访问地址回调 URL 没写对、图片链接外网访问不了道闸控制器HTTP 开闸指令控制器 IP、开闸 URL、延时设置网络隔离导致指令到不了闸机地感线圈/雷达IO 或串口触发触发信号类型、防砸逻辑串口参数不匹配、信号抖动3. 本地跑通从数据库到小程序摇起来的最短路径3.1 本地环境需要装哪些东西本地跑通这套系统环境准备是关键缺一个组件启动就会失败。服务端如果是 Java 写的需要 JDK 1.8 或 11同时确认装好 MySQL 5.7 以上版本和 Redis如果是 Node.js 写的需要 Node 14 以上的 LTS 版本。小程序端需要一个微信开发者工具管理后台如果是 Vue 项目还需要 npm 或 yarn 装依赖。数据库用 Navicat 或其他客户端都可以但执行 SQL 脚本时要注意字符集下面会专门讲这个坑。我建议的安装顺序是MySQL → Redis → JDK/Node → 微信开发者工具。前面三个是给服务端用的最后一个是给小程序端用的。装完以后用命令确认版本这里不要凭感觉版本不对后面会出现各种奇奇怪怪的报错# 确认基础环境版本这里是我常用的检查命令 java -version node -v mysql --version redis-cli ping # 输出值参考 # java version 1.8.0_... # 服务端如果是 Spring Boot 2.xJDK8 就够 # v14.x.x # 如果 package.json 要求 Node 12这个版本没问题 # mysql Ver 8.x.x for ... # 注意 8.0 和 5.7 的认证插件差异 # PONG # 说明 Redis 服务已经起来了版本检查有几点要留意。Spring Boot 2.x 装 JDK 8 就够但如果是 Spring Boot 3.x必须 JDK 17MySQL 8.0 默认认证插件是 caching_sha2_password老一点的 JDBC 驱动不兼容会报认证失败这种情况要么改数据库用户插件为 mysql_native_password要么换新版驱动。Redis 如果本地没装很多源码启动时会直接报连接超时因为启动逻辑里一般都会连 Redis 做缓存或分布式锁。3.2 初始化数据库执行脚本前的三个检查数据库脚本是源码里最容易出问题的地方。常见的部署说明会告诉你「导入 xxx.sql 即可」但实际导入往往失败原因集中在三个方面数据库版本不兼容、字符集不一致、脚本里带定时事件或存储过程需要额外权限。我一般的做法是先用文本编辑器打开 SQL 脚本确认头部有没有 CREATE DATABASE 语句如果有说明脚本希望你自己建库如果没有需要手动建库再导入表结构。-- 第一步建库字符集一定要用 utf8mb4不是 utf8 CREATE DATABASE IF NOT EXISTS parking_system DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; -- 第二步建表核心业务表至少要有这些字段 CREATE TABLE parking_record ( id bigint(20) NOT NULL AUTO_INCREMENT, plate_no varchar(20) NOT NULL COMMENT 车牌号, parking_id bigint(20) DEFAULT NULL COMMENT 所属停车场ID, entry_time datetime DEFAULT NULL COMMENT 入场时间, exit_time datetime DEFAULT NULL COMMENT 出场时间, amount decimal(10,2) DEFAULT 0.00 COMMENT 应收金额, status tinyint(4) DEFAULT 0 COMMENT 0进行中 1已支付 2已离场, create_time datetime DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id), KEY idx_plate_no (plate_no), KEY idx_status (status) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT停车记录表;这里两个地方值得注意。第一字符集用 utf8mb4 而不是 utf8因为车牌的冷门字符和用户昵称里的表情符号utf8 存不下第二车牌号要加索引这套系统最频繁的查询就是按车牌找订单没索引数据量一上来就慢。导入完成后用show tables;确认表数量跟部署说明里的数量一致再select count(*) from xxx;看看基础数据行数是否正常比如停车费率表、车场信息表里应该有初始数据如果全是空的说明脚本可能没执行完整。3.3 启动服务端改配置、起服务、验证接口数据库就绪后开始配置服务端。配置文件一般叫 application.yml 或 application.properties里面需要改的是数据库连接、Redis 连接和端口。这里最常见的错误是只改密码不改用户名或者数据库名写错。我习惯改完配置先单独测试数据库连接再考虑启动服务避免启动报错时搞不清是代码问题还是配置问题。# application.yml 关键配置片段 server: port: 8080 # 服务端端口后面小程序要连这个端口 spring: datasource: url: jdbc:mysql://localhost:3306/parking_system?useUnicodetruecharacterEncodingutf8mb4serverTimezoneAsia/Shanghai username: root password: your_password # 换成你的本地数据库密码 redis: host: localhost port: 6379 password: # 本地没设密码就留空 database: 0配置修改完之后启动。Java 项目通常是mvn spring-boot:run或打包后java -jar xxx.jarNode.js 项目通常是npm install npm run dev。这里有个判断技巧看部署说明里给的启动命令是什么形式的如果是 mvn说明源码自带 Maven 配置如果是 npm说明依赖在 package.json 里。启动日志出现Started ... in ... seconds或者Application running at ...字样就说明启动成功了。然后打开浏览器或命令行验证接口# 用 curl 验证一个最基础的接口比如获取停车场列表 curl http://localhost:8080/api/parking/list # 正常返回类似 # {code:200,data:[{parkingId:1,parkingName:测试停车场,totalSpace:100}],msg:success}第一次跑接口时心态要放平报错是正常的。常见的错有两类一类是接口 404说明服务端启动没成功或者请求路径不对需要去 controller 里核对路由另一类是接口 500大概率是数据库查询出错去看控制台日志里的 SQL 报错基本能定位到具体表或字段。这一步如果通了主流程就完成了一半。3.4 小程序端跑起来改一个地址开一个开关小程序端的配置比服务端简单但有一个概念必须先理解开发工具里的「不校验合法域名」选项只对开发调试有效一旦上了真机预览这个开关就不起作用了。所以在本地开发阶段小程序端的 config 文件里需要把请求地址指向本地服务端的 IP 和端口。// 小程序端 utils/config.js 常见写法 module.exports { // 开发环境指向本地电脑的局域网 IP不是 localhost baseUrl: http://192.168.1.100:8080, // 生产环境后面部署上线时改成你的正式域名 prodUrl: https://park.example.com }这里有个细节必须提醒真机预览时如果你用localhost或127.0.0.1作为 baseUrl手机访问的是它自己不是你的电脑。正确做法是填电脑的局域网 IP并且保证手机和电脑在同一个 WiFi 下。还有一层容易踩的是防火墙Windows 电脑默认会拦截来自局域网的端口访问需要在防火墙里放行 8080 端口否则手机会提示网络连接失败。在微信开发者工具里导入小程序项目时要填自己的 AppID如果只用测试号部分能力比如支付可能不可用。导入后第一步是检查工具右上角是否开启了「不校验合法域名、web-view业务域名、TLS 版本以及 HTTPS 证书」这个调试选项本地开发必须勾上然后编译运行看到首页能拉到停车场列表就算本地跑通了。4. 部署上线域名、HTTPS 与服务器进程守护4.1 服务器端把服务跑起来并守护进程本地跑通只算走了一半流程部署上线才是真正考验功底的地方。先把服务端代码打成可执行包Java 项目是 jarNode 项目是一整个目录然后用scp或直接走 Git 传到服务器。我见过不少人本地跑得好好的一部署就崩根源是服务器上环境版本和本地不一致建议服务器上单独装一套和本地一致的运行时版本别图省事用系统自带的旧版本。进程守护是必须做的裸跑java -jar一旦退出终端进程就没了SSH 断开服务也跟着断这种情况见得太多了。常见做法是 systemd 或 supervisor把服务注册成系统服务崩了自动重启。下面是一份 Java 服务的 systemd 配置示例# /etc/systemd/system/parking-server.service [Unit] DescriptionParking System Server Afternetwork.target mysql.service redis.service [Service] Typesimple Userwww-data WorkingDirectory/srv/parking ExecStart/usr/bin/java -jar /srv/parking/parking-server.jar --spring.profiles.activeprod Restartalways RestartSec5 EnvironmentTZAsia/Shanghai [Install] WantedBymulti-user.target # 生效命令 # sudo systemctl daemon-reload # sudo systemctl enable parking-server # sudo systemctl start parking-server这份配置里几个参数值得展开。After表示在 MySQL 和 Redis 起来之后再启动服务避免启动时连不上数据库导致初始化失败Restartalways是关键进程异常退出会自动拉起这是「半夜服务挂了没人管」场景下的后悔药EnvironmentTZAsia/Shanghai是给计费系统用的停车费按时间算服务器时区如果默认是 UTC就会出现计费时间差 8 小时翻车。启动后用systemctl status parking-server确认状态再 curl 一下本机接口确认服务在服务器上正常响应。4.2 配置 Nginx 反向代理和 HTTPS 证书小程序平台对接口的强制要求是 HTTPS而且证书校验很严格自签名证书过不了必须用受信任的 CA 签发的证书。常见的申请渠道有云厂商的免费证书一般一年期也可以用自动化签发工具。申请到证书后把证书文件放到服务器上再用 Nginx 做反向代理把公网域名转发到本机的服务端口。下面是一份可以直接改域名套用的 Nginx 配置# /etc/nginx/conf.d/parking.conf server { listen 443 ssl http2; server_name park.example.com; # 换成你自己的域名 ssl_certificate /etc/nginx/cert/park.pem; # 证书文件路径 ssl_certificate_key /etc/nginx/cert/park.key; # 私钥文件路径 ssl_protocols TLSv1.2 TLSv1.3; # 小程序要求 TLS 版本不能太低 location /api/ { proxy_pass http://127.0.0.1:8080; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; } } server { listen 80; server_name park.example.com; # 把 HTTP 请求全部跳转到 HTTPS return 301 https://$host$request_uri; }这段配置里最容易被忽略的是location /api/的路径匹配。如果服务端的接口路由是/api/xxxNginx 转发时默认会保留完整路径也就是把/api/parking/list原样转发给后端所以在后端接口里必须存在这个路径如果后端路由不带/api前缀就需要用proxy_pass http://127.0.0.1:8080/;配合重写去掉前缀这个只有试了才知道。配置文件改完后记得nginx -t检查语法然后systemctl reload nginx让配置生效再通过在线测试工具确认域名返回的证书链完整。4.3 小程序端切换到正式域名并发布小程序端上线前的最后一步是把开发环境的 baseUrl 改成正式 HTTPS 域名然后在小程序后台完成域名校验和版本提审。这里的「正式」两个字很关键因为开发工具里勾选的「不校验合法域名」到了真机上直接失效所有请求都会失败提示网络错误或域名不在合法列表。所以上生产环境前必须去小程序后台把 request 合法域名配置成自己的 HTTPS 域名这一步不需要写代码但漏掉的概率极高。// 小程序端 config.js切换环境时只需要改这一处 module.exports { // 生产环境正式域名 baseUrl: https://park.example.com, // 如果服务端做了签名校验这里还要配置对应的密钥或 token requestTimeout: 10000 }发布前我习惯在开发者工具里依次做三件事清缓存、重新编译、真机预览。清缓存是排除旧代码残留重新编译是确认最新配置生效真机预览是模拟真实用户环境。这三步都过了再上传代码到小程序后台提交审核。等待审核期间可以顺便检查两个生产环境特有的配置收款用的商户号是否已经绑定到小程序以及电子发票接口是否已经在服务端初始化。很多项目卡在审核环节不是因为代码有问题而是商户号的关联关系没配置好审核人员测试支付流程时直接失败被打回再重新排队来回就是好几天。5. 停车场源码落地最容易翻车的几个位置5.1 小程序真机请求报「网络错误」现象开发工具里一切正常一到手机预览就请求失败报错信息要么是「网络异常」要么是「不在以下 request 合法域名列表中」。原因真机不认开发工具的「不校验合法域名」所有请求域名必须在小程序后台登记过如果是 HTTP 协议直接就被拦截了。解决确认线上接口是 HTTPS去小程序后台把域名加入 request 合法域名同时确认服务器证书完整。这里有一个很容易忽略的细节合法域名要求域名和证书完全匹配如果用 IP 访问或域名不一致同样会失败。我处理过的某次线上事故就是证书和域名不是同一个主体小程序端请求直接静默失败。5.2 数据库导入成功小程序里却看不到任何车位现象SQL 脚本执行成功但小程序登录后车场列表是空的手动插一条数据后又能看到。原因很多源码做了多租户或所属车场的逻辑过滤小程序端请求接口时会带上当前用户的 parkId 或 ownerId初始数据里的车场归属和当前登录用户不匹配数据被接口层过滤掉了。解决去数据库查看管理员表和小程序用户表的关联关系把车场记录的user_id或owner_id改成当前测试账号的 ID。这类问题表面看是 bug实际是设计如此源码自带的初始数据绑定的是演示账号用自己注册的账号登录自然什么都看不到。排查时先把 SQL 查出来的原始数据和管理后台页面显示的数据做对比能快速定位是哪一层丢的。5.3 本地正常运行Linux 服务器上 500现象同一个 jar 包或同一套 Node 代码本地 Windows 上一切正常传到服务器后接口报 500日志里要么是表找不到要么是 SQL 报错。原因最常见的三个差异是数据库表名大小写、时区、Redis 配置。Linux 上 MySQL 默认区分大小写Windows 上不区分源码里如果用了ParkingRecord而表名建的是parking_record在 Windows 上没问题到 Linux 上直接报错时区问题影响计费时间偏差Redis 密码或端口不一致则会导致登录态失效。解决先看日志定位具体报错行表名问题统一改成小写或者在 MySQL 配置文件里设置lower_case_table_names1时区在 JDBC 连接串上加serverTimezoneAsia/ShanghaiRedis 配置和本地对齐。这套排查路径可以覆盖大部分「本地好、线上崩」的场景。5.4 车牌识别相机的数据进不了系统现象相机已经识别到车牌管理后台却看不到入场记录相机日志显示回调发送成功。原因相机回调的 URL 配置的是http://server_ip:8080/api/camera/callback但服务端部署在 Nginx 后面默认只开放了 443 端口或者服务器防火墙没放行 8080回调请求根本到不了服务端。另一个常见原因是回调接口地址写的是内网 IP服务端在云端内网 IP 无法路由。解决把回调地址改成公网可达的 HTTPS 地址并在服务端的回调接口日志里确认请求是否进来同时把相机 IP 加入服务器的白名单避免被安全策略拦截。硬件对接出问题第一步永远是抓日志看请求到底有没有到达服务端而不是去调代码。5.5 支付拉起失败商户信息未配置或回调地址错误现象小程序端点击缴费后支付界面加载不出来或支付成功后订单状态没更新。原因支付能力没有在小程序后台开通或者商户号和 AppID 没有绑定支付回调地址没有配置到公网可达的 HTTPS 地址导致支付平台的通知送不到服务端。解决先在小程序后台确认支付能力已开通再确认商户号与 AppID 已完成关联服务端的支付回调接口路径必须是一个外网可访问的 HTTPS 地址并且要在支付平台后台配置好本地开发可以用内网穿透工具临时测试线上必须用正式域名。另外支付成功后订单状态不同步基本上都是回调地址配置错误不是代码逻辑问题优先排查这一环。6. 把源码改造成月卡计费一个最小改法拿到一套停车场源码之后最常被要求的改动不是修 bug而是加固定车位月卡功能。原本按时计费的系统要支持「月卡用户不限次数进出」或者「月卡时长内不扣费」这个需求在交付现场几乎必出现。其实不需要大改核心思路是用户表加一个月卡到期时间字段出场结算时先判断是否月卡用户且未过期满足条件直接放行不进入按小时计费逻辑。-- 给用户表增加月卡到期时间和月卡类型字段 ALTER TABLE user_info ADD COLUMN monthly_card_expire datetime DEFAULT NULL COMMENT 月卡到期时间NULL为无月卡, ADD COLUMN monthly_card_type tinyint(4) DEFAULT 0 COMMENT 0无月卡 1标准月卡 2VIP月卡;后端出场结算逻辑只需要加一个分支判断在原有的按时间计费之前先拦截。Java 伪代码如下// 出场结算核心判断逻辑 if (user.getMonthlyCardExpire() ! null user.getMonthlyCardExpire().after(new Date())) { // 月卡有效期内直接出场不生成支付订单 record.setAmount(BigDecimal.ZERO); record.setStatus(2); // 2代表已离场 // 调道闸开闸 gateService.open(record.getParkingId()); return Result.success(月卡用户免费通行); } // 非月卡或月卡过期走原有按小时计费逻辑 BigDecimal amount calculateAmount(record);这段改造有几个边界要考虑清楚。月卡到期时间比较的是服务器时间和数据库时间之前提过的时区问题在这里会直接影响判断必须保证用的是同一时区月卡过期当天按临时车计费还是给缓冲时间这个业务规则要和甲方确认清楚再定不要自己拍板小程序端也要有月卡购买和到期提醒入口只是展示层加个按钮后端加一个购买接口把到期时间往后延一个月逻辑并不复杂。我经手过的某项目中这套月卡逻辑上线后的最大问题不是代码而是运营人员不知道月卡用户在出场时会被自动放行导致月底对账发现大量零元订单来询问是不是系统 bug。所以改造完成后一定要和现场管理人员讲清楚规则月卡车不产生费用记录但会产生出入场记录方便后续追溯。这也是我养成的习惯交付代码时同步交付一套业务规则说明比只给部署文档省心得多。停车场源码的落地从来不是把服务跑起来就结束而是让业务闭环真正转起来希望这篇笔记能帮到你。本文还有配套的精品资源点击获取