基于Spring Boot + Vue.js的GPT AI聊天应用：从开发到部署的完整实践
前言一个人一个下午做成的，为了应对周四的作业答辩。🚀 项目概述本文将详细介绍一个基于Spring Boot后端和Vue.js前端的GPT AI聊天应用的完整开发流程。该项目集成了OpenAI、阿里云通义千问、DeepSeek、豆包、Kimi等多个主流AI平台，支持文本对话和图像生成功能，并实现了用户认证、会话管理、管理员面板、用户统计等完整的业务功能。体验地址：https://gpt.xuan.cyou/技术栈后端: Spring Boot 3.5.5, Java 17, SQLite, JPA/Hibernate前端: Vue.js 3, Vite, Pinia, JavaScript ES6+AI集成: OpenAI GPT-4, 阿里云通义千问, DeepSeek, 豆包, Kimi部署: 宝塔面板, Nginx, SSL证书📁 项目架构GPT-AI-Project/ ├── gpt-ai-java/ # Spring Boot 后端 │ ├── src/main/java/ │ │ ├── controller/ # REST API控制器 (用户, AI, 管理员等) │ │ ├── service/ # 业务逻辑层 (多AI平台服务, 用户统计等) │ │ ├── entity/ # 数据实体 (用户, 对话历史, 统计数据等) │ │ ├── config/ # 配置类 │ │ └── adopter/ # AI平台适配器 (OpenAI, Ali, DeepSeek, Kimi等) │ ├── src/main/resources/ │ │ └── application.yaml # 应用配置 │ └── pom.xml # Maven依赖配置 └── frontend/ # Vue.js 前端 ├── src/ │ ├── components/ # Vue组件 │ ├── views/ # 页面视图 (聊天, 图像, 管理面板, 用户后台等) │ ├── api/ # API调用封装 │ └── store/ # 状态管理 (Pinia) ├── public/ # 静态资源 └── package.json # NPM依赖配置🔧 核心功能实现1. 后端核心架构1.1 多AI平台集成项目支持OpenAI和阿里云通义千问两个AI平台，通过适配器模式实现：// AI控制器统一入口 @RestController @RequestMapping("/api/ai") public class AiController { @GetMapping("/chat/text/stream") public SseEmitter streamChat( @RequestParam String platform, @RequestParam String model, @RequestParam String message ) { // 根据平台选择对应的AI服务 (示例) if ("openai".equals(platform)) { return openAiController.sendTextStream(model, message); } else if ("ali".equals(platform)) { return aliAiController.sendTextStream(model, message); } // ... 此处添加对 deepseek, doubao, kimi 等平台的路由逻辑 return null; // or throw an exception } }1.2 流式响应实现使用Server-Sent Events (SSE) 实现实时流式对话：@PostMapping("/chat/text/stream") public SseEmitter sendTextStream(String model, String message) { SseEmitter emitter = new SseEmitter(0L); CompletableFuture.runAsync(() -> { try { // 流式读取AI响应并实时推送 openAIService.sendText(model, message, true, delta -> { emitter.send(SseEmitter.event().name("delta").data(delta)); }); emitter.send(SseEmitter.event().name("done").data("[DONE]")); emitter.complete(); } catch (Exception ex) { emitter.completeWithError(ex); } }); return emitter; }1.3 会话管理系统实现了完整的对话历史记录功能：@Entity public class ConversationHistory { @Id @GeneratedValue(strategy = GenerationType.IDENTITY) private Long id; private String userId; private String sessionId; private String userMessage; private String assistantReply; private LocalDateTime timestamp; // ... getters and setters }1.4 跨域配置为支持前后端分离和域名部署，配置了完整的CORS支持：@Configuration public class CorsConfig implements WebMvcConfigurer { @Override public void addCorsMappings(CorsRegistry registry) { registry.addMapping("/**") .allowedOriginPatterns( "http://localhost:*", "https://gpt.xuan.cyou" ) .allowedMethods("GET", "POST", "PUT", "DELETE", "OPTIONS") .allowCredentials(true); } }2. 前端核心实现2.1 API客户端封装统一封装所有后端API调用：// 流式聊天 export function streamChat({ platform, model, message, onDelta, onDone }) { const url = `/api/ai/chat/text/stream?platform=${platform}&model=${model}&message=${encodeURIComponent(message)}`; const eventSource = new EventSource(url); eventSource.addEventListener('delta', (event) => { const data = JSON.parse(event.data); onDelta?.(data.delta); }); eventSource.addEventListener('done', () => { onDone?.(); eventSource.close(); }); } // 图像生成 export async function createImage(params) { const response = await fetch('/api/ai/create/image', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify(params) }); return await response.json(); }2.2 实时对话界面Vue.js实现的流式对话体验： AI正在回复... 2.3 状态管理 (Pinia)项目使用Pinia进行全局状态管理，取代了Vuex，提供了更简洁的API和完整的TypeScript支持。// src/store/index.js import { defineStore } from 'pinia' export const useMainStore = defineStore('main', { state: () => ({ user: null, currentSession: null, settings: { platform: 'openai', textModel: 'gpt-4o-mini', imageModel: 'dall-e-3', backendUrl: 'http://localhost:8083' } }), actions: { setUser(user) { this.user = user; }, updateSettings(settings) { this.settings = { ...this.settings, ...settings }; } } })🛠️ 开发环境搭建1. 后端开发环境# 1. 克隆项目 git clone <repository-url> cd gpt-ai-java # 2. 配置application.yaml server: port: 8083 spring: application: name: gpt-ai datasource: url: jdbc:sqlite:identifier.sqlite driver-class-name: org.sqlite.JDBC # 3. 运行项目 mvn spring-boot:run2. 前端开发环境# 1. 安装依赖 cd frontend npm install # 2. 配置开发代理 # vite.config.js const target = process.env.BACKEND_URL || 'http://localhost:8083' export default defineConfig({ server: { proxy: { '/api': { target, changeOrigin: true } } } }) # 3. 启动开发服务器 npm run dev📦 生产环境部署1. 后端打包部署# Maven打包 mvn clean package -DskipTests # 部署运行 java -jar target/gpt-ai-0.0.1-SNAPSHOT.jar # 或使用systemd守护进程 sudo systemctl start gpt-ai2. 前端构建部署# 构建生产版本 npm run build # 部署到服务器 # 将dist/目录下所有文件上传到 /www/wwwroot/gpt.xuan.cyou/dist/3. Nginx配置针对宝塔面板的完整Nginx配置：server { listen 80; listen 443 ssl http2; server_name gpt.xuan.cyou; root /www/wwwroot/gpt.xuan.cyou/dist; # SSL配置 ssl_certificate /www/server/panel/vhost/cert/gpt.xuan.cyou/fullchain.pem; ssl_certificate_key /www/server/panel/vhost/cert/gpt.xuan.cyou/privkey.pem; # API代理到后端服务 location /api/ { proxy_pass http://127.0.0.1:8083; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; # 支持SSE长连接 proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection "upgrade"; proxy_read_timeout 3600s; proxy_send_timeout 3600s; } # Vue.js SPA路由支持 location / { try_files $uri $uri/ @fallback; } location @fallback { rewrite ^.*$ /index.html last; } # 静态资源缓存优化 location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg)$ { expires 1y; add_header Cache-Control "public, immutable"; } }🎯 核心功能特性1. 多AI平台支持OpenAI集成: 支持GPT-4系列模型，DALL-E图像生成阿里云集成: 支持通义千问文本对话，通义万相图像生成新增平台: 已集成DeepSeek, 豆包, Kimi等更多主流AI模型统一接口: 通过platform参数无缝切换不同AI服务2. 实时流式对话SSE技术: Server-Sent Events实现实时数据推送流式体验: 模拟真实对话，逐字显示AI回复异常处理: 完善的连接错误和重连机制3. 会话管理系统历史记录: 完整保存用户对话历史会话分组: 支持多会话并行管理数据持久化: SQLite数据库存储4. 图像生成功能多平台支持: OpenAI DALL-E和阿里云通义万相参数配置: 支持不同尺寸和风格设置结果展示: 优雅的图像展示和下载功能5. 用户认证系统登录注册: 基本的用户认证功能权限控制: 用户数据隔离和访问控制设置管理: 个性化配置保存6. 管理员面板用户管理: 查看、管理所有注册用户系统监控: 实时查看系统使用统计数据数据分析: 提供用户行为和AI使用情况的图表分析7. 用户统计个人仪表板: 用户可以查看自己的AI使用历史和统计数据用量跟踪: 详细记录每日和累计的token使用量可视化图表: 直观展示个人使用趋势🔍 技术亮点1. 前后端分离架构RESTful API: 标准的REST接口设计跨域处理: 完善的CORS配置支持代理配置: 开发环境和生产环境的统一代理方案2. 响应式设计移动适配: 支持手机、平板等多种设备现代UI: 简洁美观的用户界面交互体验: 流畅的动画和反馈效果3. 性能优化静态资源缓存: 合理的缓存策略Gzip压缩: 减少传输数据量懒加载: 按需加载提升首屏速度4. 部署友好容器化支持: 可轻松容器化部署宝塔面板: 兼容主流服务器管理面板SSL支持: HTTPS安全访问🚨 常见问题解决1. API代理404错误问题: 前端API请求返回404错误解决: 确保Nginx配置了正确的API代理规则2. SSE连接中断问题: 流式对话中途断开解决: 配置Nginx的proxy_read_timeout参数3. 跨域问题问题: 浏览器CORS错误解决: 检查后端CORS配置和Nginx代理头设置4. 静态资源404问题: Vue路由刷新后404解决: 配置Nginx的try_files规则📈 未来扩展方向1. 功能增强语音对话: 集成语音识别和合成文件上传: 支持文档分析功能插件系统: 可扩展的功能插件架构2. 技术优化缓存机制: Redis缓存提升性能消息队列: 异步处理大量请求微服务架构: 拆分为多个独立服务3. 运维改进监控告警: 完善的系统监控日志分析: ELK日志分析栈自动部署: CI/CD持续集成部署💡 总结本项目展示了一个完整的现代Web应用开发流程，从技术选型、架构设计到开发实现和生产部署，涵盖了全栈开发的各个环节。通过Spring Boot和Vue.js的组合，实现了高效、可维护的前后端分离架构。项目的核心价值在于：技术栈现代化: 采用最新的技术栈和最佳实践功能完整性: 涵盖了AI对话应用的核心功能部署友好性: 支持多种部署方式和环境扩展性良好: 架构设计便于后续功能扩展希望本文能为想要开发类似AI应用的开发者提供有价值的参考和指导。Gitee仓库：前端 - https://gitee.com/wx6765/chatgpt_frontend后端 - https://gitee.com/wx6765/chatgpt_backend本文基于实际项目开发经验总结，代码示例均来自真实项目实现。
前端开发中嵌入B站视频播放器：解决high_quality=1 失效的问题
问题背景在前端开发中，我们可能需要嵌入B站视频。使用B站官方播放器时，遇到了以下问题：默认画质被限制在360p高清画质需要登录B站账号部分视频需要大会员才能观看高清版本问题分析默认的B站原生播放器 存在的问题：画质限制：即使设置了high_quality=1和quality=720，实际播放时仍被限制在360p，这两个方法在22年就失效了登录要求：高清画质需要用户登录B站账号会员限制：部分视频的高清版本需要大会员权限解决方案改进后的高清解析播放器[hide] [/hide]优势：画质提升：可以直接获取视频源默认画质，1080p同样生效无需登录：用户无需登录B站账号突破限制：可以观看部分需要大会员的视频总结通过使用视频解析接口，成功解决了B站视频播放器的画质限制问题。希望这个解决方案对你有所帮助，有问题请在评论区交流。
智慧零工平台前端开发实战：从uni-app到跨平台应用
本文将详细介绍我如何使用uni-app框架开发一个支持微信小程序和H5的零工平台前端应用，包含技术选型、架构设计、核心功能实现及部署经验。前言在当今移动互联网时代，跨平台开发已成为提高开发效率的重要手段。本次我选择uni-app框架开发了一个智慧零工平台的前端应用，该平台致力于为零工与雇主搭建高效便捷的双向服务桥梁。项目概况项目名称: 智慧零工平台前端系统技术栈: Vue.js 2.6 + uni-app 3.0 + ColorUI支持平台: 微信小程序 + H5项目地址: GitHub - Gigplatform_front在线预览: https://lgpt.xuan.cyou/技术选型分析为什么选择uni-app？在众多跨平台解决方案中，我最终选择了uni-app，主要基于以下考虑：一套代码多端运行: 支持编译到微信小程序、H5、App等10+平台学习成本低: 基于Vue.js语法，前端开发者容易上手生态完善: 拥有丰富的组件库和插件市场性能优异: 接近原生应用的性能表现社区活跃: DCloud官方维护，社区支持良好核心技术栈{ "前端框架": "Vue.js 2.6.11", "跨平台框架": "uni-app 3.0", "UI组件库": "ColorUI 2.1.6", "样式预处理": "SCSS/SASS", "状态管理": "Vuex", "构建工具": "webpack", "开发工具": "HBuilderX" }项目架构设计整体架构项目采用模块化架构设计，清晰分离业务逻辑和技术实现：smart-gig-platform-front/ ├── api/ # API接口层 ├── components/ # 公共组件 ├── pages/ # 页面文件 ├── employerPackage/ # 雇主端分包 ├── static/ # 静态资源 ├── store/ # 状态管理 ├── colorui/ # UI组件库 └── utils/ # 工具函数分包策略为了优化小程序包体积，我采用了分包加载策略：{ "subPackages": [ { "root": "employerPackage", "name": "employer", "pages": [ "pages/center/index", "pages/postJob/index", "pages/resume/index" ] } ] }这样可以将雇主端功能独立打包，减少主包体积，提升首屏加载速度。核心功能实现1. 双重身份系统这是项目的一大特色功能，用户可以在零工和雇主身份间无缝切换： <view class="identity-switch"> <view class="switch-container"> <view class="switch-item" :class="{ active: currentRole === 'worker' }" @click="switchRole('worker')" > <image src="/static/img/worker-icon.png" /> <text>我是零工</text> </view> <view class="switch-item" :class="{ active: currentRole === 'employer' }" @click="switchRole('employer')" > <image src="/static/img/employer-icon.png" /> <text>我是雇主</text> </view> </view> </view> 2. 地理位置服务实现基于位置的工作推荐功能：// 获取用户位置 async getUserLocation() { try { const res = await uni.getLocation({ type: 'wgs84' }) this.userLocation = { latitude: res.latitude, longitude: res.longitude } // 获取附近工作 await this.getNearbyJobs() } catch (error) { console.error('获取位置失败:', error) uni.showToast({ title: '位置获取失败', icon: 'none' }) } }, // 计算距离 calculateDistance(lat1, lon1, lat2, lon2) { const R = 6371 // 地球半径(km) const dLat = (lat2 - lat1) * Math.PI / 180 const dLon = (lon2 - lon1) * Math.PI / 180 const a = Math.sin(dLat/2) * Math.sin(dLat/2) + Math.cos(lat1 * Math.PI / 180) * Math.cos(lat2 * Math.PI / 180) * Math.sin(dLon/2) * Math.sin(dLon/2) const c = 2 * Math.atan2(Math.sqrt(a), Math.sqrt(1-a)) return R * c }3. 智能搜索与筛选实现多维度的工作搜索功能： <view class="search-container"> <view class="search-bar"> 搜索 </view> <view class="filter-section"> <picker :value="selectedCategory" :range="categories" range-key="name" @change="onCategoryChange" > <view class="filter-item"> {{ selectedCategory ? categories[selectedCategory].name : '选择分类' }} </view> </picker> <picker :value="selectedSalary" :range="salaryRanges" @change="onSalaryChange" > <view class="filter-item"> {{ selectedSalary ? salaryRanges[selectedSalary] : '薪资范围' }} </view> </picker> </view> <scroll-view scroll-y class="job-list" @scrolltolower="loadMore" > <job-card v-for="job in jobList" :key="job.id" :job-data="job" @click="goToDetail(job.id)" /> </scroll-view> </view> 4. 实时消息系统实现雇主与零工间的实时通信：// WebSocket连接管理 class MessageService { constructor() { this.socket = null this.reconnectAttempts = 0 this.maxReconnectAttempts = 5 } connect(userId) { try { this.socket = uni.connectSocket({ url: `wss://lgpt.ybyq.wang/ws/${userId}`, header: { 'Authorization': uni.getStorageSync('token') } }) this.socket.onOpen(() => { console.log('WebSocket连接成功') this.reconnectAttempts = 0 }) this.socket.onMessage((res) => { const message = JSON.parse(res.data) this.handleMessage(message) }) this.socket.onClose(() => { console.log('WebSocket连接关闭') this.reconnect() }) this.socket.onError((error) => { console.error('WebSocket错误:', error) this.reconnect() }) } catch (error) { console.error('WebSocket连接失败:', error) } } sendMessage(message) { if (this.socket) { this.socket.send({ data: JSON.stringify(message) }) } } handleMessage(message) { // 处理接收到的消息 switch (message.type) { case 'chat': this.updateChatList(message) break case 'notification': this.showNotification(message) break case 'status_update': this.updateApplicationStatus(message) break } } reconnect() { if (this.reconnectAttempts < this.maxReconnectAttempts) { setTimeout(() => { this.reconnectAttempts++ this.connect() }, 2000 * this.reconnectAttempts) } } }响应式设计与适配多端适配策略为了确保在不同平台上的一致体验，我采用了以下适配策略：// 使用rpx单位进行响应式设计 .container { padding: 20rpx; // H5端特殊处理 /* #ifdef H5 */ max-width: 750rpx; margin: 0 auto; /* #endif */ // 微信小程序特殊处理 /* #ifdef MP-WEIXIN */ padding-top: calc(20rpx + env(safe-area-inset-top)); /* #endif */ } // 统一的颜色变量 $primary-color: #4CAF50; $success-color: #4CAF50; $warning-color: #FF9800; $danger-color: #F44336; // 字体大小规范 $font-size-xs: 22rpx; $font-size-sm: 24rpx; $font-size-base: 28rpx; $font-size-lg: 32rpx; $font-size-xl: 36rpx;组件化开发开发了一系列可复用组件，提高开发效率： <view class="job-card" @click="handleClick"> <view class="job-header"> <view class="job-title">{{ jobData.title }}</view> <view class="job-salary text-primary">{{ jobData.salary }}</view> </view> <view class="job-info"> <view class="company-name">{{ jobData.companyName }}</view> <view class="job-location"> <text class="icon-location"></text> {{ jobData.location }} </view> </view> <view class="job-tags"> <view v-for="tag in jobData.tags" :key="tag" class="tag" > {{ tag }} </view> </view> <view class="job-footer"> <view class="publish-time">{{ formatTime(jobData.publishTime) }}</view> <view class="apply-count">{{ jobData.applyCount }}人申请</view> </view> </view> 性能优化实践1. 图片优化// 图片懒加载 Vue.directive('lazy-load', { bind(el, binding) { const observer = new IntersectionObserver((entries) => { entries.forEach(entry => { if (entry.isIntersecting) { el.src = binding.value observer.unobserve(el) } }) }) observer.observe(el) } }) // 图片压缩处理 function compressImage(file, quality = 0.8) { return new Promise((resolve) => { const canvas = document.createElement('canvas') const ctx = canvas.getContext('2d') const img = new Image() img.onload = () => { canvas.width = img.width canvas.height = img.height ctx.drawImage(img, 0, 0) canvas.toBlob(resolve, 'image/jpeg', quality) } img.src = URL.createObjectURL(file) }) }2. 数据缓存策略// API数据缓存 class CacheManager { constructor() { this.cache = new Map() this.expireTime = 5 * 60 * 1000 // 5分钟 } set(key, data) { this.cache.set(key, { data, timestamp: Date.now() }) } get(key) { const item = this.cache.get(key) if (!item) return null if (Date.now() - item.timestamp > this.expireTime) { this.cache.delete(key) return null } return item.data } clear() { this.cache.clear() } } // 使用示例 async function fetchJobList(params) { const cacheKey = `job_list_${JSON.stringify(params)}` const cachedData = cacheManager.get(cacheKey) if (cachedData) { return cachedData } const response = await api.getJobList(params) cacheManager.set(cacheKey, response.data) return response.data }3. 代码分割与按需加载// 路由懒加载 const routes = [ { path: '/pages/jobDetail/jobDetail', component: () => import('@/pages/jobDetail/jobDetail.vue') }, { path: '/pages/employer/index', component: () => import('@/pages/employer/index.vue') } ] // 组件按需引入 export default { components: { JobCard: () => import('@/components/job-card.vue'), FilterPanel: () => import('@/components/filter-panel.vue') } }部署与发布H5部署构建生产版本npm run build:h5服务器配置server { listen 80; server_name lgpt.ybyq.wang; root /www/wwwroot/lgpt.ybyq.wang/h5; index index.html; # SPA路由支持 location / { try_files $uri $uri/ /index.html; } # API代理 location /api/ { proxy_pass https://lgpt.ybyq.wang:8081/api/; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; } # 静态资源缓存 location ~* \.(js|css|png|jpg|jpeg|gif|svg|woff|woff2)$ { expires 1y; add_header Cache-Control "public, immutable"; } # Gzip压缩 gzip on; gzip_types text/plain text/css application/json application/javascript text/xml application/xml application/xml+rss text/javascript; }微信小程序发布构建小程序版本npm run build:mp-weixin小程序配置{ "appid": "your-app-id", "projectname": "智慧零工平台", "setting": { "urlCheck": false, "es6": true, "postcss": true, "minified": true, "newFeature": true }, "compileType": "miniprogram" }发布流程使用微信开发者工具导入项目配置合法域名白名单进行真机测试提交审核并发布开发经验总结遇到的挑战跨平台兼容性问题不同平台API差异样式表现不一致事件处理机制差异性能优化挑战小程序包体积限制长列表渲染性能图片加载优化用户体验优化网络异常处理加载状态管理错误边界处理最佳实践代码组织// 统一的错误处理 Vue.config.errorHandler = (err, vm, info) => { console.error('Vue Error:', err, info) // 上报错误日志 reportError(err, info) } // 全局混入 Vue.mixin({ methods: { $showLoading(title = '加载中...') { uni.showLoading({ title }) }, $hideLoading() { uni.hideLoading() }, $showToast(title, icon = 'none') { uni.showToast({ title, icon }) } } })API请求封装// request.js const request = (options) => { return new Promise((resolve, reject) => { uni.request({ url: BASE_URL + options.url, method: options.method || 'GET', data: options.data || {}, header: { 'Content-Type': 'application/json', 'Authorization': getToken(), ...options.header }, success: (res) => { if (res.data.code === 0) { resolve(res.data) } else { uni.showToast({ title: res.data.message, icon: 'none' }) reject(res.data) } }, fail: (error) => { uni.showToast({ title: '网络错误', icon: 'none' }) reject(error) } }) }) }状态管理// store/index.js import Vue from 'vue' import Vuex from 'vuex' Vue.use(Vuex) export default new Vuex.Store({ state: { userInfo: null, userRole: 'worker', // worker | employer jobList: [], messageList: [] }, mutations: { SET_USER_INFO(state, userInfo) { state.userInfo = userInfo uni.setStorageSync('userInfo', userInfo) }, SET_USER_ROLE(state, role) { state.userRole = role uni.setStorageSync('userRole', role) } }, actions: { async login({ commit }, loginData) { try { const response = await api.login(loginData) const { token, user } = response.data uni.setStorageSync('token', token) commit('SET_USER_INFO', user) return response } catch (error) { throw error } } } })未来规划功能扩展增加语音通话功能实现AR技能展示加入AI智能推荐技术升级升级到Vue 3 + Composition API引入TypeScript增强类型安全使用Vite提升构建性能用户体验优化加入暗黑模式支持优化无障碍访问提升加载性能结语通过这次uni-app跨平台开发实践，我深刻体会到了现代前端技术的强大能力。uni-app让我们能够用一套代码覆盖多个平台，大大提高了开发效率。项目中最有价值的经验包括：合理的架构设计是项目成功的基础组件化开发能显著提高代码复用率性能优化需要从多个维度综合考虑用户体验是产品成功的关键因素希望这篇文章能为正在学习uni-app或准备进行跨平台开发的朋友们提供一些参考和启发。项目链接:🌐 在线预览: https://lgpt.ybyq.wang/💻 GitHub仓库: https://github.com/BXCQ/Gigplatform_front📚 技术博客: https://blog.ybyq.wang/如果您对项目有任何问题或建议，欢迎在GitHub上提Issue或通过邮箱 676567473@qq.com 联系我！
在微信小程序开发过程中，轮播图组件(swiper)是常用的UI元素，但在实际应用中经常遇到高度不匹配导致的空白问题。本文详细记录了一次轮播图高度优化的完整过程，特别是针对固定宽高比图片的精确适配方案。问题背景在开发"零工市场"微信小程序时，首页包含一个轮播图组件。轮播图使用了三张尺寸为516×145像素的图片，但在实际显示时，轮播图区域为414×207，导致底部出现了大量空白区域，影响了整体页面美观度。初步尝试方案1. 使用自动高度方式最初尝试使用mode="widthFix"来保持图片宽高比，但默认的轮播图组件不会自动适应图片高度，仍然会出现空白。<swiper class="screen-swiper square-dot" :indicator-dots="true" :autoplay="true" :circular="true" :interval="3000" :duration="500"> <swiper-item v-for="(item, index) in banners" :key="index"> <image :src="item.imageUrl" mode="widthFix" class="swiper-image"></image> </swiper-item> </swiper>效果：图片本身按原始比例显示，不会变形但轮播图容器的高度没有随图片高度自动调整，底部依然存在大量空白指示点位置可能不正确，过于靠下2. 尝试强制变形适应接着尝试使用scaleToFill模式强制图片填充整个容器区域，但这种方法会导致图片变形。<swiper class="screen-swiper" :indicator-dots="true" :autoplay="true" :circular="true" :interval="3000" :duration="500" :style="{height: bannerHeight}"> <swiper-item v-for="(item, index) in banners" :key="index"> <image :src="item.imageUrl" mode="scaleToFill" class="swiper-image"></image> </swiper-item> </swiper>效果：图片被强制拉伸填充整个容器，没有空白内容显示不完整视觉效果较差3. 尝试使用aspectFit模式为了保持图片比例不变形，尝试使用aspectFit模式，但这种方式会在上下两侧产生空白。<swiper class="screen-swiper" :indicator-dots="true" :autoplay="true" :circular="true" :interval="3000" :duration="500" :style="{height: bannerHeight}"> <swiper-item v-for="(item, index) in banners" :key="index"> <image :src="item.imageUrl" mode="aspectFit" class="swiper-image"></image> </swiper-item> </swiper>效果：图片保持原始比例，不会变形但图片两侧或上下出现空白，实际显示尺寸较小没有完全利用容器空间最终解决方案经过多次尝试后，找到了最佳解决方案：结合使用外层容器和精确比例计算。核心代码实现1. HTML结构改进：使用外层容器<view class="banner-wrapper" :style="{height: bannerHeight}"> <swiper class="screen-swiper" :indicator-dots="true" :indicator-color="'rgba(255, 255, 255, .3)'" :indicator-active-color="'#ffffff'" :autoplay="true" :circular="true" :interval="3000" :duration="500"> <swiper-item v-for="(item, index) in banners" :key="index" @tap="bannerTap(item)"> <image :src="item.imageUrl" mode="widthFix" class="swiper-image"></image> </swiper-item> </swiper> </view>效果：轮播图外层容器高度通过精确计算，刚好与图片等高图片完整显示，保持原始比例，不会变形完全没有多余的空白区域，图片宽度占满整个容器宽度整体显示效果紧凑、自然、美观，指示点位于图片内部底部在不同屏幕尺寸下都能保持正确的显示比例2. 精确计算容器高度// 预加载轮播图第一张图片以获取高度 preloadBannerImage() { // 直接根据已知图片比例计算 // 原图为516 × 145，比例约为3.559:1 const windowWidth = uni.getSystemInfoSync().windowWidth // 根据屏幕宽度和图片比例计算高度 const imgHeight = windowWidth / (516/145) this.bannerHeight = imgHeight + 'px' console.log("Banner height calculated:", this.bannerHeight, "Screen width:", windowWidth) }3. CSS样式优化.banner-wrapper { width: 100%; margin: 0; padding: 0; overflow: hidden; position: relative; } .screen-swiper { width: 100%; height: 100%; .swiper-image { width: 100%; display: block; } }方案原理解析这个解决方案的核心在于：使用外部容器控制高度：不直接设置swiper组件的高度，而是通过外部容器banner-wrapper控制整体高度。精确计算比例：根据原始图片的确切宽高比(516÷145)计算出在当前屏幕宽度下应该显示的准确高度。保持图片比例：使用mode="widthFix"确保图片保持原始比例显示，不会变形。图片填充整个区域：通过设置图片width: 100%确保图片横向完全填充容器。优势不需要复杂CSS：避免了使用复杂的CSS强制控制内部元素精确匹配：容器高度与图片实际显示高度完全一致不会变形：图片保持原始比例，不会被拉伸变形响应式适配：在不同宽度的设备上都能保持正确比例避免额外空白：完全消除了轮播图下方的多余空白完整实现效果经过优化后，轮播图区域高度刚好与图片显示高度一致，图片不变形，没有多余空白，整体页面布局更加紧凑美观。而且这种方案能够适应不同尺寸的设备，始终保持图片的正确显示比例。适用场景这种方案特别适用于以下场景：轮播图图片具有固定的宽高比需要精确控制轮播图区域高度要求图片不能变形或被裁剪页面布局需要紧凑，不允许有额外空白总结通过精确计算图片显示高度并使用外层容器控制轮播图区域，成功解决了微信小程序中轮播图高度自适应的问题。这种方案不仅保证了图片不变形，还确保了轮播图区域的高度精确匹配图片显示高度，从而提升了整体页面的美观度和用户体验。对于需要精确控制轮播图显示效果的小程序开发者，这是一个简单有效的解决方案。各次方案效果对比总结：widthFix：图片不变形但有空白。scaleToFill：无空白但图片变形。aspectFit：图片不变形但有边空白。最终方案（推荐）：图片不变形、无空白、比例自适应，最美观。
uniapp-文件查找失败: ‘@dcloudio/uni-ui/lib/uni-icons/uni-icons.vue‘
今天在HBuilderX中使用uniapp开发微信小程序时遇到了这个问题：uniapp-文件查找失败：'@dcloudio/uni-ui/lib/uni-icons/uni-icons.vue'，就是找不到uni-ui组件我当时创建项目，选择了一个中间带+的底部带选项卡模板，并没有选择内置uni-ui的项目模板，因为是第一次用，并不知道前者中没有引入uni-ui看了看官方文档，有三种导入方式1、新建项目时，直接选择uni-ui模板2、使用 uni_modules 方式安装组件库，可以直接通过插件市场导入3、使用npm+easycom引入，在终端执行npm i @dcloudio/uni-ui 或 yarn add @dcloudio/uni-ui报错原因我用的是npm+easycom引入的，pages.json中已经引入了easycom，但是文件夹中的内容是空的，找不到文件。解决办法注释掉easycom那几行代码，删掉左边的文件夹，然后使用上面说的第二种方式导入组件即可。
1. 简介在 Uniapp 开发中，自定义 Tabbar 是一个常见的需求。本教程将详细介绍如何实现一个美观且功能完整的自定义 Tabbar，并分享在实现过程中可能遇到的问题和解决方案。2. 实现步骤2.1 创建自定义 Tabbar 组件首先，我们需要创建一个自定义的 Tabbar 组件。以下是完整的实现代码： <view class="custom-tabbar"> <view v-for="(item, index) in tabList" :key="index" class="tabbar-item" :class="{'tabbar-item-active': current === index}" @click="switchTab(item.pagePath)" > <van-icon :name="current === index ? item.selectedIcon : item.icon" class="tabbar-icon" :class="{'tabbar-icon-active': current === index}" /> <text>{{ item.text }}</text> </view> </view> 2.2 配置 pages.json在 pages.json 中需要禁用原生 Tabbar，并配置页面路由：{ "tabBar": { "custom": true, // 启用自定义 Tabbar "list": [ { "pagePath": "pages/index/index", "text": "首页" }, { "pagePath": "pages/detail/detail", "text": "详情" }, { "pagePath": "pages/course/course", "text": "课程" }, { "pagePath": "pages/profile/profile", "text": "我的" } ] } }3. 实现过程中的关键点3.1 路由映射使用 TAB_ROUTES 对象来映射路由路径和对应的索引值，这样可以方便地管理当前选中的 tab：const TAB_ROUTES = { '/pages/index/index': 0, '/pages/detail/detail': 1, '/pages/course/course': 2, '/pages/profile/profile': 3 };3.2 样式设计使用 position: fixed 确保 Tabbar 固定在底部添加 env(safe-area-inset-bottom) 适配全面屏手机使用 box-shadow 添加阴影效果实现点击缩放动画效果添加底部指示条3.3 图标处理使用 van-icon 组件（来自 Vant UI）来显示图标，通过 :class 动态切换选中状态。4. 常见问题及解决方案4.1 页面跳转问题问题：使用 uni.switchTab 跳转时可能出现页面不更新的情况。解决方案：确保在 pages.json 中正确配置了 tabBar使用 uni.switchTab 而不是 uni.navigateTo在 watch 中监听路由变化，及时更新选中状态4.2 样式适配问题问题：在不同机型上可能出现底部遮挡或样式错乱。解决方案：使用 env(safe-area-inset-bottom) 适配全面屏设置合适的 z-index 确保层级正确使用 rpx 单位确保在不同设备上显示一致4.3 性能优化问题：频繁切换可能导致性能问题。解决方案：使用 v-for 时添加 :key合理使用 watch 监听路由变化避免在 Tabbar 中加载过多资源5. 扩展功能5.1 添加徽标可以在 Tabbar 项上添加徽标，显示未读消息数量等：<view class="tabbar-item"> <van-icon :name="icon" /> <text>{{ text }}</text> <view v-if="badge" class="badge">{{ badge }}</view> </view>5.2 添加动画效果可以添加更丰富的动画效果，如：.tabbar-item { transition: all 0.3s cubic-bezier(0.4, 0, 0.2, 1); } .tabbar-item:hover { transform: translateY(-5rpx); }6. 总结通过以上步骤，我们实现了一个功能完整、样式美观的自定义 Tabbar。这个实现方案具有以下特点：支持路由跳转适配不同机型提供良好的视觉反馈性能优化易于扩展
前期准备1. 注册微信开放平台访问微信开放平台注册开发者账号完成开发者资质认证创建网站应用2. 获取必要的参数AppID：应用的唯一标识AppSecret：应用密钥网站域名：需要配置的网站域名回调域名：用户授权后跳转的域名3. 配置安全域名登录微信开放平台进入"网站应用"管理添加网站域名下载验证文件并上传到网站根目录开发步骤1. 引入微信JS-SDK 2. 配置微信JS-SDKwx.config({ debug: false, // 开启调试模式 appId: '你的AppID', timestamp: '', // 生成签名的时间戳 nonceStr: '', // 生成签名的随机串 signature: '', // 签名 jsApiList: [] // 需要使用的JS接口列表 });3. 实现登录流程3.1 获取授权码function getWechatAuth() { const appid = '你的AppID'; const redirect_uri = encodeURIComponent('你的回调地址'); const scope = 'snsapi_login'; // 授权作用域 const state = '随机字符串'; // 防CSRF攻击 const url = `https://open.weixin.qq.com/connect/qrconnect?appid=${appid}&redirect_uri=${redirect_uri}&response_type=code&scope=${scope}&state=${state}#wechat_redirect`; window.location.href = url; }3.2 获取访问令牌async function getAccessToken(code) { const appid = '你的AppID'; const secret = '你的AppSecret'; try { const response = await fetch(`https://api.weixin.qq.com/sns/oauth2/access_token?appid=${appid}&secret=${secret}&code=${code}&grant_type=authorization_code`); const data = await response.json(); return data; } catch (error) { console.error('获取访问令牌失败:', error); return null; } }3.3 获取用户信息async function getUserInfo(access_token, openid) { try { const response = await fetch(`https://api.weixin.qq.com/sns/userinfo?access_token=${access_token}&openid=${openid}`); const data = await response.json(); return data; } catch (error) { console.error('获取用户信息失败:', error); return null; } }4. 处理回调// 在回调页面处理授权码 const urlParams = new URLSearchParams(window.location.search); const code = urlParams.get('code'); const state = urlParams.get('state'); if (code && state) { // 验证state防止CSRF攻击 if (state === '你之前生成的随机字符串') { // 获取访问令牌 const tokenData = await getAccessToken(code); if (tokenData) { // 获取用户信息 const userInfo = await getUserInfo(tokenData.access_token, tokenData.openid); if (userInfo) { // 处理用户信息，如保存到本地存储或发送到服务器 handleUserInfo(userInfo); } } } }注意事项1. 安全相关state参数：必须使用随机字符串，防止CSRF攻击HTTPS：必须使用HTTPS协议域名验证：确保域名与开放平台配置一致密钥保护：AppSecret必须妥善保管，不要暴露在前端2. 用户体验登录按钮：使用微信官方提供的按钮样式错误处理：友好的错误提示加载状态：显示加载中的状态登录状态：合理处理登录状态过期3. 性能优化缓存处理：合理使用localStorage缓存登录状态请求优化：减少不必要的接口调用错误重试：适当的重试机制常见问题1. 授权失败检查域名是否配置正确验证AppID和AppSecret是否正确确认回调地址是否编码正确2. 获取用户信息失败检查access_token是否有效确认scope是否包含必要权限验证openid是否正确3. 跨域问题确保服务器配置了正确的CORS头检查请求头是否包含必要信息验证域名是否在允许列表中最佳实践1. 代码组织// 建议的代码结构 const WechatLogin = { config: { appId: '你的AppID', redirectUri: '你的回调地址' }, init() { // 初始化配置 }, login() { // 处理登录逻辑 }, handleCallback() { // 处理回调逻辑 }, getUserInfo() { // 获取用户信息 } };2. 错误处理function handleError(error) { const errorMap = { '40029': '无效的授权码', '40163': '授权码已使用', '41002': '缺少必要参数' }; const message = errorMap[error.errcode] || '未知错误'; console.error(`微信登录错误: ${message}`); // 显示错误提示给用户 }结论通过以上步骤，我们可以成功在H5网站中接入微信登录功能。在实际开发中，还需要根据具体业务需求进行适当的调整和优化。建议在开发过程中多参考微信开放平台的官方文档，确保功能的正确实现。参考链接微信开放平台文档微信JS-SDK说明文档微信登录开发指南
在进行前端开发时，我们经常需要和后端进行数据交互。在这个过程中，Ajax和axios是我们最常用的两个工具。今天，我就来和大家聊聊它们的区别。什么是Ajax？Ajax（Asynchronous JavaScript and XML）是一种在网页中实现异步数据交互的技术。简单来说，就是可以在不刷新整个页面的情况下，向服务器发送请求并获取数据。举个生活中的例子：就像你在餐厅点餐，服务员（Ajax）可以帮你把菜单（请求）送到厨房（服务器），然后把做好的菜（响应）端回来，而不需要你亲自去厨房。什么是Promise？在讲axios之前，我们先来了解一下Promise。Promise是JavaScript中处理异步操作的一种方式，你可以把它想象成一个"承诺"。比如你约朋友吃饭：你发出邀请（创建Promise）朋友可能答应（resolve）或拒绝（reject）如果答应，你们就一起去吃饭（then）如果拒绝，你就自己吃（catch）// Promise的基本使用 const promise = new Promise((resolve, reject) => { // 模拟异步操作 setTimeout(() => { const success = true; if (success) { resolve('操作成功！'); } else { reject('操作失败！'); } }, 1000); }); promise .then(result => console.log(result)) .catch(error => console.error(error));什么是axios？axios是一个基于Promise的HTTP客户端，专门用于处理网络请求。你可以把它理解为一个"升级版"的Ajax工具包。主要区别1. 使用方式Ajax：需要自己创建XMLHttpRequest对象，写起来比较麻烦const xhr = new XMLHttpRequest(); xhr.open('GET', 'https://api.example.com/data'); xhr.onreadystatechange = function() { if (xhr.readyState === 4 && xhr.status === 200) { console.log(xhr.responseText); } }; xhr.send();axios：使用起来简单直观axios.get('https://api.example.com/data') .then(response => { console.log(response.data); }) .catch(error => { console.error(error); });2. 功能特性Ajax：基础功能：发送请求、接收响应需要自己处理很多细节代码量较大// 发送POST请求 const xhr = new XMLHttpRequest(); xhr.open('POST', 'https://api.example.com/data'); xhr.setRequestHeader('Content-Type', 'application/json'); xhr.onreadystatechange = function() { if (xhr.readyState === 4) { if (xhr.status === 200) { console.log(JSON.parse(xhr.responseText)); } else { console.error('请求失败'); } } }; xhr.send(JSON.stringify({ name: '张三', age: 20 }));axios：自动转换JSON数据支持Promise可以拦截请求和响应可以取消请求自动处理错误支持CSRF保护// 发送POST请求 axios.post('https://api.example.com/data', { name: '张三', age: 20 }) .then(response => { console.log(response.data); }) .catch(error => { console.error(error); }); // 请求拦截器 axios.interceptors.request.use(config => { // 在发送请求之前做些什么 config.headers['Authorization'] = 'Bearer token'; return config; }); // 响应拦截器 axios.interceptors.response.use(response => { // 对响应数据做点什么 return response; }, error => { // 对响应错误做点什么 return Promise.reject(error); });3. 适用场景Ajax：简单的数据请求对项目大小有严格限制不需要太多高级功能axios：大型项目需要处理复杂的数据交互需要更好的错误处理需要统一的请求管理优缺点对比Ajax的优点原生支持，不需要额外引入库体积小，适合轻量级项目学习成本低Ajax的缺点代码冗长需要自己处理很多细节不支持Promise错误处理比较麻烦axios的优点使用简单，代码简洁功能丰富支持Promise错误处理完善支持请求拦截和响应拦截axios的缺点需要额外引入库对于简单项目来说可能有点"重"总结如果你是初学者，建议先学习Ajax，因为它是基础。当你开始做实际项目时，axios会是更好的选择，它能让你写更少的代码，做更多的事。希望这篇文章能帮助你理解Ajax和axios的区别。如果你有任何问题，欢迎在评论区留言讨论！
基于uni-app的健身会员管理系统前端技术分析项目背景本来是打算做一个会员管理的wx小程序，由于我开始前未弄清楚wx小程序原生语言和uniapp都分别支持什么组件，只知道uniapp可以开发小程序，直接就使用了vue3+vant4组件。做到最后要打包为微信小程序时傻了眼，成堆报错，查了查错误后才知道几乎都是vant4组件的错，根本用不了。查了查才知道vant weapp是专门用于小程序和app的组件，所以我就全部替换了，发现还是不行：页内跳转方法不对，底部导航栏导航方法也不对。。。于是索性不改了，还好备份过，h5就h5吧。业主后来想通过微信小程序来给他的会员发送到期请续费的通知（服务号通知）。但是经过我对这块狠狠地补习后，我发现目前的系统并不能做到这点，需要让会员们通过微信授权登录进来（但是感觉纯H5网站实现微信授权登录挺麻烦的），这样的话可以获取到他们的微信用户信息，就能通过服务号发送给每位授权登录的会员。我突然想到可不可以使用微信原生框架开发一个只做登录，登录的请求和返回都对应做好的这个h5网站，这样的话既能用微信官方登录接口，登录后的画面是这个h5网站，两全其美。但是哪有我想的这莫简单，微信虽然有一个<webview>可以做外部网站的显示容器，但是需要设置授权，所以行不通。后面我会单独发一篇文章，关于微信小程序开发方式以及我碰到的全部麻烦。最后我找到了一个公众号，专门转发这种通知，但有限制。所以最后到期通知只能发给业主自己，且没有会员登录的功能。后面会发一篇后端和数据库的实现以及如何部署。项目概述这是一个基于uni-app开发的健身会员管理系统，主要用于管理会员信息、课程进度以及发送到期提醒等功能。项目采用了Vue 3 + Vite的技术栈，整体架构清晰，代码组织规范。技术栈前端框架：Vue 3构建工具：ViteUI组件库：Vant weappHTTP请求：Axios跨端框架：uni-appAPI设计与实现1. 请求配置与拦截器项目使用了axios进行HTTP请求，并配置了完整的请求拦截和响应拦截机制。让我们来看看具体的实现：// 后端API配置 const backendAPI = { baseUrl: "/api", } // 创建axios实例 const instance = axios.create({ baseURL: backendAPI.baseUrl, timeout: 30000, headers: { 'Content-Type': 'application/json', 'Accept': 'application/json' }, withCredentials: true })这段代码创建了一个axios实例，设置了基本的请求配置：baseURL: 设置API的基础路径timeout: 设置请求超时时间为30秒headers: 设置请求头，指定内容类型为JSONwithCredentials: 允许跨域请求携带cookieAPI路径配置详解在代码中出现的 /api 是一个API的基础路径（base URL），它表示：代理路径：在开发环境中，这个 /api 通常会被配置为代理路径比如当你在本地开发时，请求 /api/member/list 实际上会被代理到 http://localhost:3000/member/list 这样的实际后端地址实际作用：它作为所有API请求的前缀比如 getMemberList 方法实际请求的完整URL是 /api/member/list这样可以统一管理所有API的路径配置方式：在 vite.config.js 中通常会配置代理，类似这样：server: { proxy: { '/api': { target: 'http://localhost:3000', changeOrigin: true } } }实际部署时：在生产环境中，这个 /api 可能会指向实际的服务器地址比如 https://api.yourdomain.com这样设计的好处是：开发时可以使用代理避免跨域问题部署时只需要修改代理配置，不需要改代码统一管理所有API请求的路径前缀2. 请求拦截器instance.interceptors.request.use( config => { const token = uni.getStorageSync('token') if (token) { config.headers['Authorization'] = `Bearer ${token.trim()}` } return config }, error => { return Promise.reject(error) } )请求拦截器的主要作用是：在每次请求前自动添加token到请求头使用uni.getStorageSync获取本地存储的token如果存在token，则添加到请求头的Authorization字段3. 响应拦截器instance.interceptors.response.use( response => { return response.data; }, async error => { // 错误处理逻辑 if (!error.response) { uni.showToast({ title: '网络连接失败，请检查网络设置', icon: 'none', duration: 2000 }); } // ... 其他错误处理 return Promise.reject(error); } )响应拦截器的主要功能：统一处理响应数据，直接返回response.data处理各种错误情况，如网络错误、服务器错误等使用uni-app的showToast方法展示错误提示4. API方法封装项目将所有的API请求方法进行了统一封装，例如：export const { adminLogin, getAdminProfile, getMemberList, // ... 其他方法 } = { adminLogin: (username, password) => instance.post('/admin/login', { username, password }) .then(response => { if (response.code === 200 && response.data.token) { uni.setStorageSync('token', response.data.token) uni.setStorageSync('adminInfo', response.data.admin) return response } return Promise.reject(new Error(response.message || '登录失败')) }), getAdminProfile: () => instance.get('/admin/profile'), getMemberList: () => instance.get('/member/list'), // ... 其他方法实现 }这种封装方式的优点：统一管理所有API请求每个方法都有清晰的错误处理登录成功后自动保存token和用户信息使用Promise链式调用，代码更易读5. 权限管理实现项目中使用了基于token的权限管理机制，主要通过以下方式实现：登录认证：adminLogin: (username, password) => instance.post('/admin/login', { username, password }) .then(response => { if (response.code === 200 && response.data.token) { // 保存token和用户信息 uni.setStorageSync('token', response.data.token) uni.setStorageSync('adminInfo', response.data.admin) uni.setStorageSync('tokenExpireTime', Date.now() + `365 *` 24 * 60 * 60 * 1000) return response } return Promise.reject(new Error(response.message || '登录失败')) })Token验证：每次请求都会在请求头中携带token通过请求拦截器自动添加tokeninstance.interceptors.request.use( config => { const token = uni.getStorageSync('token') if (token) { config.headers['Authorization'] = `Bearer ${token.trim()}` } return config } )权限控制：401错误处理：当token无效或过期时，自动跳转到登录页if (error.response.status === 401) { uni.removeStorageSync('token') uni.removeStorageSync('adminInfo') uni.removeStorageSync('tokenExpireTime') uni.showToast({ title: '登录已过期，请重新登录', icon: 'none', duration: 2000 }); setTimeout(() => { uni.reLaunch({ url: '/pages/login/index' }); }, 2000); }权限特点：使用JWT（JSON Web Token）进行身份验证token有效期设置为1年（我设置的*365，默认是一天）自动处理token过期情况统一的权限错误处理机制登录状态持久化存储安全措施：token存储在本地存储中请求时自动添加Bearer认证敏感操作需要重新验证登出时清除所有认证信息这种权限管理方式的优点：无状态：服务器不需要存储session安全性：使用JWT保证数据完整性灵活性：可以携带用户信息可扩展：易于添加新的权限控制用户体验：自动处理登录状态系统权限扩展建议由于该系统我只实现了管理员登录，如果要支持普通用户和会员登录，可以按以下方式扩展（仅供参考）：用户角色设计（数据库设计也可以按此方式）：// 用户角色分类 const UserRole = { ADMIN: 'admin', // 管理员 MEMBER: 'member', // 会员 USER: 'user' // 普通用户 } // 权限级别 const PermissionLevel = { SUPER_ADMIN: 3, // 超级管理员 ADMIN: 2, // 普通管理员 MEMBER: 1, // 会员 USER: 0 // 普通用户 }登录接口扩展：// 扩展登录方法 export const { userLogin, // 普通用户登录 memberLogin, // 会员登录 adminLogin // 管理员登录 } = { userLogin: (username, password) => instance.post('/user/login', { username, password }) .then(response => { if (response.code === 200) { uni.setStorageSync('token', response.data.token) uni.setStorageSync('userInfo', response.data.user) uni.setStorageSync('userRole', UserRole.USER) return response } return Promise.reject(new Error(response.message || '登录失败')) }), memberLogin: (username, password) => instance.post('/member/login', { username, password }) .then(response => { if (response.code === 200) { uni.setStorageSync('token', response.data.token) uni.setStorageSync('memberInfo', response.data.member) uni.setStorageSync('userRole', UserRole.MEMBER) return response } return Promise.reject(new Error(response.message || '登录失败')) }) }权限验证中间件：// 权限验证工具 const checkPermission = (requiredLevel) => { const userRole = uni.getStorageSync('userRole') const currentLevel = PermissionLevel[userRole.toUpperCase()] return currentLevel >= requiredLevel } // 路由守卫 const routerGuard = (to, from, next) => { const token = uni.getStorageSync('token') if (!token) { next('/login') return } // 根据路由meta信息检查权限 if (to.meta.requiredLevel && !checkPermission(to.meta.requiredLevel)) { uni.showToast({ title: '权限不足', icon: 'none' }) next(from.path) return } next() }API权限控制：// 请求拦截器中添加角色验证 instance.interceptors.request.use( config => { const token = uni.getStorageSync('token') const userRole = uni.getStorageSync('userRole') if (token) { config.headers['Authorization'] = `Bearer ${token.trim()}` config.headers['X-User-Role'] = userRole } return config } )功能权限控制示例：// 会员管理功能 const memberManagement = { // 只有管理员可以查看所有会员 getAllMembers: () => { if (!checkPermission(PermissionLevel.ADMIN)) { return Promise.reject(new Error('权限不足')) } return instance.get('/member/list') }, // 会员可以查看自己的信息 getMemberInfo: (id) => { const currentUserId = uni.getStorageSync('memberInfo')?.id if (id !== currentUserId && !checkPermission(PermissionLevel.ADMIN)) { return Promise.reject(new Error('权限不足')) } return instance.get(`/member/${id}`) } }页面权限控制：// 页面配置示例 const pages = [ { path: '/admin/dashboard', meta: { requiredLevel: PermissionLevel.ADMIN, title: '管理后台' } }, { path: '/member/profile', meta: { requiredLevel: PermissionLevel.MEMBER, title: '会员中心' } }, { path: '/user/home', meta: { requiredLevel: PermissionLevel.USER, title: '用户首页' } } ]6. 微信通知功能项目中还实现了微信通知功能 (我这里是用的是一个第三方服务号发送的通知)，用于提醒会员到期：sendWechatNotification: (expiringMembers, expiredMembers) => { const token = 'dyhrw3Uf5Q*****8orF7J8yW0'; const title = 'XX健身-会员到期提醒'; // 格式化日期 const currentDate = new Date().toLocaleDateString('zh-CN', { year: 'numeric', month: '2-digit', day: '2-digit' }); // 构建通知内容 let content = `提醒时间: ${currentDate}\n\n`; // ... 构建会员信息内容 // 发送请求 return new Promise((resolve, reject) => { uni.request({ url: `/api/wx-push/${token}.send`, method: 'POST', data: { text: title, desp: content }, success: (res) => resolve(res.data), fail: (err) => reject(err) }); }); }这个功能的特点：使用uni.request发送请求支持Promise异步处理格式化日期显示构建结构化的通知内容总结这个项目展示了如何在一个uni-app项目中：使用axios进行API请求管理实现完整的请求拦截和响应拦截统一处理错误和提示封装API方法实现微信通知等特色功能对于想要学习uni-app开发的同学来说，这个项目是一个很好的参考案例。它展示了如何组织代码、处理API请求、管理状态等实际开发中常见的问题。学习建议先理解项目的基本架构和目录结构重点学习API请求的封装方式掌握错误处理和拦截器的使用了解uni-app特有的API（如uni.request、uni.showToast等）尝试自己实现一些简单的功能，如会员信息的增删改查