1. 项目概述与核心价值最近在筹备一个线上活动需要一个公平、透明且能实时统计的抽奖系统。市面上的第三方工具要么功能臃肿要么数据不透明要么就是费用不菲。作为一个喜欢折腾的开发者我决定自己动手用最熟悉的 React Node.js 技术栈从零搭建一个轻量级但功能完整的抽奖系统。这个项目我把它命名为lottery-system它不仅实现了基础的随机抽奖还内置了管理员后台、详细的访问统计和中奖记录追踪非常适合公司内部活动、社区运营或者小型线上营销场景。这个系统的核心价值在于“可控”和“透明”。可控意味着你可以完全自定义奖品池、中奖概率和活动规则所有数据都掌握在自己手里。透明是指整个抽奖过程有迹可循从谁在什么时候访问了页面到最终谁中了什么奖所有记录都清晰可查杜绝了“黑箱操作”的嫌疑。对于刚接触全栈开发的朋友来说这也是一个非常好的练手项目涵盖了前端界面、后端API、数据库操作、用户认证和服务器部署等一整套流程。接下来我就把这个项目的设计思路、关键技术实现和踩过的坑毫无保留地分享给大家。2. 技术栈选型与架构设计2.1 为什么选择 React Express SQLite 这个组合在技术选型上我遵循了“快速开发、易于部署、维护简单”的原则。前端选择React Vite是因为React的组件化开发模式非常适合构建这种交互复杂的单页面应用抽奖的转盘动画、结果弹窗都可以封装成独立的组件复用和维护起来非常方便。Vite作为构建工具其极快的冷启动和热更新速度能极大提升开发体验告别了以往等待Webpack打包的漫长时光。后端选择了Node.js Express这是Node.js生态里最经典、最轻量的Web框架。抽奖系统的后端逻辑并不复杂主要是提供奖品配置、抽奖API、记录日志和后台管理接口Express完全能够胜任而且中间件机制非常灵活比如我们用express-jwt来做接口鉴权就非常方便。数据库方面我选择了SQLite。对于这样一个轻量级应用它简直是绝配。SQLite是一个进程内的数据库不需要像MySQL或PostgreSQL那样单独安装和运行一个数据库服务它的数据库文件就是一个普通的.db文件备份和迁移都非常简单。虽然它不适合高并发的写操作但我们的抽奖活动通常并发量不会太高SQLite的性能完全足够而且极大地简化了部署复杂度。2.2 整体架构与数据流设计整个系统采用经典的前后端分离架构。前端是一个静态的React应用通过HTTP API与后端通信。后端Express应用提供RESTful API并直接操作SQLite数据库。数据流是这样的用户访问前端页面前端加载活动配置和奖品列表。用户点击抽奖按钮前端向后端的/api/lottery/draw接口发起请求。后端接口收到请求后首先会记录这次访问的IP地址用于统计然后根据预设的奖品概率算法随机选出一个奖品。选中奖品后后端会检查该奖品的库存是否充足并确保同一用户通常根据IP或登录态是否达到抽奖次数上限。通过所有校验后后端将中奖结果存入winners表并减少对应奖品的库存最后将中奖信息返回给前端。前端以炫酷的动画效果展示中奖结果。管理员可以通过专属后台登录查看实时访问统计、中奖记录并能管理奖品库存和活动规则。这种分离的架构让前后端可以独立开发和部署前端打包后可以直接扔到Nginx下后端服务用PM2守护进程结构清晰职责分明。3. 核心功能模块实现细节3.1 抽奖算法与概率控制抽奖的核心在于“随机”与“可控”。我们既要保证结果是随机的又要能控制不同奖品的中奖概率。我采用的是一种“权重区间”的算法既简单又有效。首先在后台配置奖品时除了奖品名称、图片、库存还有一个关键字段叫weight权重。权重是一个整数代表了该奖品的中奖概率权重。比如我们设置三个奖品一等奖权重1、二等奖权重3、谢谢参与权重6。那么总权重就是 13610。当用户抽奖时后端会执行以下逻辑// 1. 从数据库获取所有有效奖品库存0 const prizes await db.all(SELECT * FROM prizes WHERE stock 0); // 2. 计算总权重 const totalWeight prizes.reduce((sum, prize) sum prize.weight, 0); // 3. 在 [1, totalWeight] 区间内生成一个随机整数 const randomNum Math.floor(Math.random() * totalWeight) 1; // 4. 遍历奖品确定随机数落在哪个奖品的权重区间内 let accumulatedWeight 0; let selectedPrize null; for (const prize of prizes) { accumulatedWeight prize.weight; if (randomNum accumulatedWeight) { selectedPrize prize; break; } }这段代码的意思是我们把总权重10想象成一条长度为10的线段。一等奖占据线段开头的1个单位二等奖占据接下来的3个单位谢谢参与占据最后的6个单位。然后我们在1-10之间随机扔一个点点落在哪个区间就中哪个奖。这样一等奖的中奖概率就是1/1010%二等奖是3/1030%谢谢参与是6/1060%。通过调整权重值你可以非常精细地控制概率比如设置一个权重为1的“超级大奖”和权重为999的“普通优惠券”实现大奖稀有、小奖多发的效果。注意这里有一个常见的坑。Math.random()生成的是 [0, 1) 的浮点数乘 totalWeight 后范围是 [0, totalWeight)。我们1并向下取整是为了得到 [1, totalWeight] 的整数确保每个权重区间都有被选中的可能并且概率是均等的。很多初学者会忘记1导致第一个奖品权重区间从0开始的概率略微降低。3.2 管理员后台与JWT认证实现后台管理是系统的控制中枢必须保证安全。我采用JWTJSON Web Token来实现无状态的登录认证。它的好处是服务器不需要存储会话减轻负担扩展性好。登录流程管理员在前端登录页输入用户名密码。前端将凭证发送到/api/admin/login。后端校验用户名密码我这里是写死在环境变量里生产环境建议用加盐哈希存储密码。校验通过后使用一个密钥JWT_SECRET签发一个JWT Token其中可以包含管理员ID、用户名和过期时间expiresIn然后返回给前端。// 后端登录接口核心代码 const jwt require(jsonwebtoken); router.post(/login, async (req, res) { const { username, password } req.body; if (username process.env.ADMIN_USERNAME password process.env.ADMIN_PASSWORD) { const token jwt.sign( { username, role: admin }, process.env.JWT_SECRET, { expiresIn: 8h } // Token 8小时后过期 ); res.json({ code: 200, message: 登录成功, token }); } else { res.status(401).json({ code: 401, message: 用户名或密码错误 }); } });前端收到Token后将其存储在localStorage或sessionStorage中。此后前端在调用任何需要权限的后台接口如获取统计数据、修改奖品时都必须在HTTP请求的Authorization头部带上这个TokenAuthorization: Bearer your_token。后端通过一个Express中间件来验证这个Token的有效性和是否过期。// JWT 验证中间件 const expressJwt require(express-jwt); const authMiddleware expressJwt({ secret: process.env.JWT_SECRET, algorithms: [HS256], credentialsRequired: true // 要求必须携带token }).unless({ path: [/api/admin/login, /api/lottery/draw] // 登录和抽奖接口不需要验证 }); app.use(authMiddleware);这样未经登录的访问者就无法访问后台管理接口保证了系统的安全性。3.3 访问统计与数据记录为了了解活动效果访问统计功能必不可少。我设计了两张核心表visits表记录每次页面访问winners表记录每一次中奖。visits表结构CREATE TABLE visits ( id INTEGER PRIMARY KEY AUTOINCREMENT, ip_address TEXT NOT NULL, user_agent TEXT, -- 通过IP查询得到的粗略地理位置可以使用第三方API或本地IP库 location TEXT, created_at DATETIME DEFAULT CURRENT_TIMESTAMP );每次用户加载前端页面时前端会向后端发送一个GET /api/visit的请求。后端在这个接口里通过req.ip获取访问者IP注意在Nginx反向代理后可能需要从X-Forwarded-For头部获取真实IP并记录User-Agent。为了获取地理位置我最初尝试调用免费的IP地理定位API但发现免费额度有限且速度慢。后来我换成了使用本地的IP地址库文件比如geoip-lite库虽然精度不如商业API但速度快、离线可用对于统计城市级别的访问分布完全足够。winners表结构CREATE TABLE winners ( id INTEGER PRIMARY KEY AUTOINCREMENT, prize_id INTEGER NOT NULL, prize_name TEXT NOT NULL, ip_address TEXT NOT NULL, -- 可以扩展字段如用户微信ID、手机号等需用户授权 contact_info TEXT, created_at DATETIME DEFAULT CURRENT_TIMESTAMP, FOREIGN KEY (prize_id) REFERENCES prizes(id) );每次抽奖成功后除了返回结果给前端后端会立即将中奖信息写入此表。这样在管理员后台我们就可以清晰地看到所有中奖记录并可以按时间、按奖品进行筛选和导出方便后续的发奖工作。4. 前端交互与用户体验优化4.1 抽奖动效与状态管理抽奖的体验至关重要一个流畅、有期待感的动画能极大提升参与度。我使用React的useState和useEffect钩子结合CSS3动画来实现。核心状态const [prizes, setPrizes] useState([]); // 奖品列表 const [isDrawing, setIsDrawing] useState(false); // 是否正在抽奖 const [result, setResult] useState(null); // 抽奖结果 const [countdown, setCountdown] useState(3); // 抽奖倒计时增加悬念抽奖流程用户点击按钮触发handleDraw函数isDrawing设为true开始一个3秒倒计时。在这3秒内前端可以快速高亮循环奖品列表模拟转盘转动效果。倒计时期间前端同时向后端发起抽奖请求。倒计时结束且后端返回结果后isDrawing设为falseresult设置为返回的奖品数据。根据result弹出精美的中奖结果模态框。实操心得动画性能是关键。避免在动画中使用会触发页面重排reflow的属性如width、height、top、left。我使用的是transform: rotate()和opacity来实现旋转和淡入淡出这些属性只触发合成composite性能开销小动画更流畅。另外一定要做好加载状态和错误状态的处理比如网络请求超时、奖品已抽完等给用户明确的反馈。4.2 响应式设计与Tailwind CSS实践为了让活动在手机和电脑上都能良好呈现我采用了响应式设计。Tailwind CSS这个工具让我事半功倍。它是一套功能类优先的CSS框架通过组合这些原子类来快速构建样式。例如一个响应式的奖品网格布局可以这样写div classNamegrid grid-cols-2 md:grid-cols-3 lg:grid-cols-4 gap-4 p-4 {prizes.map(prize ( div key{prize.id} classNamebg-white rounded-lg shadow-md p-4 text-center img src{prize.image} alt{prize.name} classNamew-full h-32 object-cover rounded mb-2/ h3 classNamefont-bold text-gray-800{prize.name}/h3 p classNametext-sm text-gray-500剩余: {prize.stock}/p /div ))} /divgrid启用网格布局。grid-cols-2在手机上显示2列。md:grid-cols-3在中等屏幕≥768px上显示3列。lg:grid-cols-4在大屏幕≥1024px上显示4列。gap-4设置网格间隙。shadow-md、rounded-lg快速添加阴影和圆角。使用Tailwind我几乎不需要写自定义的CSS文件所有样式都在JSX中声明开发效率极高而且最终打包时它会通过PurgeCSS自动移除未使用的样式保证产物体积最小。5. 后端API设计与数据库操作5.1 RESTful API 设计规范我遵循了RESTful风格来设计后端API让接口清晰易懂。功能模块请求方法接口路径描述抽奖GET/api/lottery/prizes获取当前可用的奖品列表POST/api/lottery/draw执行一次抽奖访问记录POST/api/visit记录一次页面访问后台管理POST/api/admin/login管理员登录GET/api/admin/stats获取统计数据访问量、中奖数GET/api/admin/winners获取所有中奖记录GET/PUT/DELETE/api/admin/prizes/:id对奖品进行增删改查所有接口都返回统一的JSON响应格式方便前端处理{ code: 200, message: 成功, data: { /* 具体数据 */ } }对于错误也返回相应的code和message如{“code“: 400, “message“: “奖品库存不足“}。5.2 SQLite数据库操作与优化在Node.js中操作SQLite我使用了sqlite3这个库。为了便于管理我将数据库连接和常用操作封装成了一个模块。server/db.js核心代码const sqlite3 require(sqlite3).verbose(); const path require(path); // 连接数据库如果文件不存在会自动创建 const dbPath path.join(__dirname, database, lottery.db); const db new sqlite3.Database(dbPath, (err) { if (err) { console.error(连接数据库失败:, err.message); } else { console.log(成功连接到 SQLite 数据库.); initTables(); // 连接成功后初始化数据表 } }); // 初始化表结构 function initTables() { db.run(CREATE TABLE IF NOT EXISTS prizes (...), (err) {...}); db.run(CREATE TABLE IF NOT EXISTS winners (...), (err) {...}); db.run(CREATE TABLE IF NOT EXISTS visits (...), (err) {...}); } // 封装一个Promise风格的查询方法避免回调地狱 function query(sql, params []) { return new Promise((resolve, reject) { db.all(sql, params, (err, rows) { if (err) reject(err); else resolve(rows); }); }); } function run(sql, params []) { return new Promise((resolve, reject) { db.run(sql, params, function(err) { if (err) reject(err); else resolve({ id: this.lastID, changes: this.changes }); }); }); } module.exports { db, query, run };在抽奖接口中涉及多次数据库操作查询奖品、更新库存、插入中奖记录必须保证其原子性要么全部成功要么全部失败。SQLite支持事务我通过db.run(‘BEGIN TRANSACTION‘)和db.run(‘COMMIT‘)或db.run(‘ROLLBACK‘)来实现。注意事项SQLite的写操作INSERT, UPDATE, DELETE是串行的在高并发抽奖时可能会成为瓶颈。对于预期参与人数极多的活动可以考虑以下优化1) 将抽奖逻辑中的库存检查 (stock 0) 和减少库存 (stock stock - 1) 合并到一条UPDATE语句中利用数据库的行锁。2) 如果压力极大可能需要升级到MySQL或PostgreSQL或者引入消息队列来异步处理抽奖请求。但对于绝大多数场景SQLite的性能是绰绰有余的。6. 项目部署与运维实践6.1 使用PM2进行进程守护Node.js应用在服务器上直接运行node index.js一旦进程崩溃或服务器重启服务就中断了。PM2是一个强大的Node.js进程管理器可以解决这个问题。基本使用# 全局安装PM2 npm install -g pm2 # 在项目后端目录启动应用并命名为‘lottery-backend’ pm2 start index.js --name lottery-backend # 设置开机自启动根据PM2提示保存当前进程列表并生成启动脚本 pm2 save pm2 startup # 常用命令 pm2 list # 查看所有进程状态 pm2 logs lottery-backend # 查看该应用的实时日志 pm2 restart lottery-backend # 重启应用 pm2 stop lottery-backend # 停止应用 pm2 delete lottery-backend # 删除应用PM2会自动在应用崩溃时重启它并且可以管理日志输出~/.pm2/logs/非常方便。我通常会将npm start命令写在项目的package.json中然后让PM2去执行这个命令pm2 start npm --name “lottery-backend“ -- start。6.2 Nginx配置与HTTPS设置前端构建后是静态文件后端是运行在3000端口的Node服务。我们需要一个Web服务器如Nginx作为反向代理将用户请求转发到正确的服务并处理静态文件。关键Nginx配置 (lottery.conf)server { listen 80; server_name your-domain.com; # 你的域名 # 将根路径请求指向前端构建的dist目录 location / { root /path/to/your/lottery-system/dist; index index.html; try_files $uri $uri/ /index.html; # 支持React Router的history模式 } # 将所有以 /api/ 开头的请求代理到后端的3000端口 location /api/ { proxy_pass http://localhost:3000; proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection upgrade; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; # 传递用户真实IP给后端 proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_cache_bypass $http_upgrade; } }配置好后执行sudo nginx -t检查语法无误后sudo systemctl reload nginx重载配置。启用HTTPS生产环境务必使用HTTPS保护数据传输安全。你可以使用Let‘s Encrypt的免费证书通过certbot工具自动化申请和续签。# 安装certbot (以Ubuntu为例) sudo apt update sudo apt install certbot python3-certbot-nginx # 为你的域名申请并自动配置证书 sudo certbot --nginx -d your-domain.comCertbot会自动修改你的Nginx配置设置好证书路径并强制HTTP跳转到HTTPS。6.3 环境变量管理与安全加固敏感信息绝对不能硬编码在代码里。我使用.env文件来管理环境变量并通过dotenv包在应用启动时加载。.env文件示例PORT3000 NODE_ENVproduction JWT_SECRETyour-super-long-random-secret-key-change-this-immediately ADMIN_USERNAMEmyadmin ADMIN_PASSWORDaVeryStrongPssw0rd!安全加固建议强密码与密钥JWT_SECRET和ADMIN_PASSWORD必须足够复杂建议使用密码生成器生成。限制后台访问在Nginx配置中可以为/admin路径如果你的后台路由是这个添加IP白名单限制只允许公司内网IP访问。location /admin { allow 192.168.1.0/24; # 允许的内网网段 deny all; # ... 其他代理配置 }数据库备份定期备份SQLite的.db文件到其他安全位置。可以写一个简单的脚本用crontab定时执行。日志监控关注PM2和Nginx的日志及时发现异常请求或错误。7. 常见问题排查与优化建议在实际部署和运行中你可能会遇到以下问题这里我整理了排查思路和解决方法。问题现象可能原因排查与解决前端页面空白控制台报4041. Nginx root路径配置错误。2. 前端文件未正确构建或放置。1. 检查Nginx配置中root指向的路径是否正确是否有index.html。2. 进入dist目录确认文件存在。检查构建命令是否成功。访问页面提示“无法连接到API”或网络错误1. 后端服务未启动。2. Nginx代理配置错误。3. 端口被占用或防火墙阻止。1.pm2 list检查后端进程状态。2. 检查Nginx配置中proxy_pass的地址端口是否为后端服务地址如http://localhost:3000。3. 用curl http://localhost:3000/api/lottery/prizes测试后端接口是否通。检查服务器防火墙是否开放了3000端口。抽奖接口返回“奖品库存不足”但后台显示有库存并发抽奖导致的数据竞争。两个请求同时查询库存都大于0然后都进行了减1操作。解决方案使用数据库事务并在事务内使用条件更新语句UPDATE prizes SET stock stock - 1 WHERE id ? AND stock 0。这条SQL语句本身是原子的只有库存0时才会减少并返回影响的行数。根据影响行数判断是否扣减成功。JWT Token无效或过期1. 前端未正确存储或发送Token。2. Token已过期。3. 后端JWT_SECRET被更改。1. 检查前端代码登录后是否将Token保存如localStorage并在请求头中正确设置Authorization: Bearer token。2. 检查Token的过期时间设置。前端可以在收到401错误后自动跳转登录页。3. 确保生产环境.env文件中的JWT_SECRET没有变动。管理员后台登录失败1. 环境变量ADMIN_USERNAME或ADMIN_PASSWORD未正确加载或设置。2. 数据库连接失败导致无法查询用户。1. 检查后端启动日志确认.env文件已加载。可以临时在登录接口打印环境变量值进行调试。2. 检查数据库文件路径和权限。访问统计中IP地址全是127.0.0.1应用部署在Nginx后Express默认从req.connection.remoteAddress获取的是Nginx服务器的IP。解决方案在Express中启用信任代理并正确获取真实IP。javascriptapp.set(‘trust proxy‘, true); // 信任Nginx代理const userIp req.ip性能优化建议前端对图片进行压缩使用WebP格式。利用React的React.memo或useMemo避免不必要的组件重渲染。后端对/api/lottery/prizes这类频繁读取且变化不大的接口可以添加简单的内存缓存设置一个短的过期时间如5秒减少数据库查询压力。数据库为winners和visits表的created_at字段创建索引可以加速按时间范围查询统计数据的效率CREATE INDEX idx_winners_created ON winners(created_at);。这个项目从构思到上线我花了大概一周的业余时间。最大的体会是一个看似简单的功能背后需要考虑的细节非常多从概率算法的公平性到并发请求的数据一致性再到生产环境的安全部署。自己动手搭建一遍对全栈开发的各个环节会有更深刻的理解。代码已经开源大家可以根据自己的需求随意修改和扩展比如增加微信登录、接入短信通知中奖者等等。如果在搭建过程中遇到任何问题欢迎在项目仓库提出Issue。