企业官网建设流程全解析

这几年的课程设计和毕业设计市场里，“微信小程序+交易平台”属于永远不过时的经典组合。但很多同学拿到的所谓“源码+论文+部署”大礼包，要么代码跑不起来，要么论文查重过不去，要么部署文档写得像天书。我帮人调试过太多这样的项目，今天就拿“基于微信小程序的宠物交易平台”这个题目，从技术选型、数据库设计、核心功能实现、部署上线到避坑排错，完整地把一套能答辩、能演示、能运行的项目底子给你捋清楚。这篇文章不整虚的，全是实操层面的东西。

市面上宠物交易平台的项目模板很多，但绝大多数停留在“能打开、能点几下”的演示水平。真正要拿到高分或者顺利上线，你需要弄清楚的不是代码怎么抄，而是为什么这样设计、数据怎么流转、部署时哪些环节最容易卡住。这篇文就是奔着这个目标去的，适合正在做课设的本科生、准备毕设的应届生，以及想快速搭建一个宠物交易小程序的个人开发者参考。

1. 项目整体设计与技术选型思路

1.1 为什么是微信小程序而不是App或H5

先聊聊技术选型这件事。宠物交易平台本质上是一个信息撮合加电商交易系统，C端用户需要快速浏览宠物信息、与卖家沟通、完成下单。微信小程序天然适合这种场景，它不需要下载安装，扫一扫就能用，用户获取成本极低。对于课设或毕设来说，选择微信小程序还有一个隐形的优势——微信生态自带用户身份体系，你可以直接用微信登录拿到用户的openid，省去自己搭建账号系统的巨大工作量。

很多人纠结要不要做App端或者H5端。我的建议是，主攻小程序端，后端接口设计成标准的RESTful API，这样以后想扩展App或者H5，后端代码完全不用动，只需要再写一个前端壳子就行。这种“小程序为主、API为辅”的架构，既能满足大多数课设的项目体量要求，又能在答辩时体现你有架构意识。

1.2 技术栈组合：低成本、易部署、好讲解

技术栈的选择直接决定你后续开发效率。我见过有人用Java SSH老框架做后端，折腾了半个月环境都配不好；也见过有人用纯云开发，论文里没什么好写的。最稳妥的组合是下面这套：

下面全部以后端用Spring Boot为例来展开，因为绝大多数课程里教的就是Java，用Java写后端，论文里的技术栈描述也更方便和课程知识挂钩。如果你更熟悉Node.js，思路完全一样，只是换了一套语言的表达。

1.3 核心功能范围界定

做项目最忌讳的就是“什么都想加”，最后什么都做不深。宠物交易平台的核心链路无非是三条：浏览寻宠、下单交易、订单管理。围绕这三条线，我建议把功能范围界定在这个颗粒度：

• 用户端：微信登录、宠物列表浏览（按品种/价格/地区筛选）、宠物详情、收藏、加入购物车、下单购买、订单列表、个人中心
• 卖家端（可并入用户端做角色区分）：宠物上架、宠物管理（上下架/编辑）、订单处理（发货/成交）
• 管理端（可选加分项）：用户管理、宠物审核、订单统计

这个范围做下来，工作量大概是一个月左右（一个人全栈开发，每天投入3-4小时）。如果你时间紧张，管理端可以先不做，用户端和卖家功能做扎实也完全够答辩。

2. 数据库设计与核心模块拆解

2.1 数据表结构与字段设计

数据库设计是论文里最占篇幅、也最能体现功力的部分。宠物交易平台的核心数据模型其实不复杂，关键是字段要设计得合理，避免后期返工。我按照实际开发经验，把必需的几张表给你列出来：

用户表（user）

这块要特别注意，微信登录后你拿到的只有openid、昵称、头像，手机号需要用户主动授权才能拿到。不要把手机号设计成必填字段，否则登录流程会卡住。

id: 主键自增 openid: 微信用户唯一标识（唯一索引） nickname: 昵称 avatar: 头像URL phone: 手机号（可空） role: 角色（0-普通用户，1-卖家） create_time: 创建时间

宠物信息表（pet）

这是平台的核心表，字段要多一些，因为列表页和详情页展示的信息密度不一样。

id: 主键自增 title: 宠物标题（如“三个月的金毛，疫苗齐全”） category: 品种分类（狗/猫/仓鼠/鸟类等） breed: 具体品种 price: 价格（Decimal类型，不要用Float，避免精度问题） age: 月龄 sex: 性别 vaccine: 是否已打疫苗（0/1） deworm: 是否已驱虫（0/1） description: 详细描述 cover_image: 封面图 images: 详情图（JSON数组存储多个图片URL） seller_id: 关联用户表id status: 状态（0-待审核，1-在售，2-已售出，3-下架） view_count: 浏览量 create_time: 发布时间

这里有个设计细节很多人会忽略——状态字段一定要设计成int类型，不要用字符串。原因很简单：后续做筛选列表时，in查询和索引命中都更高效，而且状态流转的代码逻辑更好写。

订单表（order）

订单表的设计是整个项目的关键难点。宠物交易和普通电商的区别在于，它更偏向“闲置交易”逻辑，但为了课设演示方便，可以直接套用标准电商订单流程。

id: 主键自增 order_no: 订单编号（唯一，用时间戳+随机数生成） pet_id: 关联宠物id buyer_id: 买家id seller_id: 卖家id amount: 订单金额 status: 订单状态（0-待付款，1-已付款，2-已完成，3-已取消） pay_time: 支付时间（可空） create_time: 下单时间

收藏表（favorite）

id: 主键自增 user_id: 用户id pet_id: 宠物id create_time: 收藏时间

注意：收藏表要加唯一约束(user_id, pet_id)，防止用户重复收藏同一条宠物，这个细节在答辩时如果你主动提出来，老师会加分。

2.2 订单状态机的流转设计

订单模块是项目中逻辑最复杂的一块，也是论文中“核心业务设计”章节的重点素材。我建议用状态机的方式管理订单状态，代码结构清晰，答辩讲起来也有条理。

订单状态的流转路径是这样的：

• 用户点击“立即购买”或“结算购物车” -> 生成订单，状态为待付款(0)
• 用户模拟支付或调用微信支付 -> 支付成功回调 -> 状态改为已付款(1)
• 卖家看到已付款订单 -> 确认发货或线下交易完成 -> 状态改为已完成(2)
• 待付款状态下用户主动取消或超时未支付 -> 状态改为已取消(3)

这里有个业务上的坑要提前说：宠物交易平台在真实场景里通常支持“买家拍下后卖家确认”，也就是C2C模式。但课设项目里，为了避免业务流程过于复杂，我建议直接简化成“买家下单即成交”的B2C模式，也就是管理员或卖家发布宠物，买家直接购买，不涉及砍价、议价、卖家二次确认这个环节。这个简化不影响项目完整性，反而让代码路径更清晰，论文里的业务流程图更好画。 ### 2.3 图片存储的两种方案 宠物交易平台最核心的展示内容就是宠物图片，图片处理方案一定要提前定好，不然后期会很痛苦。 **方案一：本地存储（推荐课设使用）** 后端在服务器上创建一个`upload`目录，通过接口接收小程序端上传的图片文件，保存到本地，同时返回可访问的URL路径。这个方案完全免费，本地开发调试最方便，而且不需要申请OSS。 但要注意两点：第一，服务器上要有足够的磁盘空间，一张宠物图片一般几百KB，100张图也就几十MB，课设规模完全够用；第二，要让Nginx或Spring Boot的静态资源映射指向这个upload目录，保证图片URL可以正常访问。 **方案二：阿里云OSS（推荐上线使用）** 如果项目要真实上线运行，图片存本地是行不通的——服务器磁盘有限，而且备份迁移麻烦。OSS对象存储的用法和本地文件系统很像，只是写入操作变成了调用SDK的`putObject`方法。OSS的优势是有CDN加速，图片加载速度快，还不用担心磁盘爆掉。 我的建议是：代码层面做一个图片上传接口的抽象，本地开发和部署时用本地存储的实现，如果以后上云，替换成OSS实现即可。这个设计点写在论文里，能体现你有工程意识。 ## 3. 小程序端核心功能实现与实操要点 ### 3.1 项目初始化和自定义TabBar 微信小程序的项目初始化本身很简单，用微信开发者工具直接新建项目，填入AppID就能起步。但有个细节会导致你的页面加载永远报错——**不校验合法域名**这个选项只在开发调试时有用，真实上线必须在小程序后台配置。 我习惯先把项目目录规划好，pages下面建四个主tab页面：`home`首页、`category`分类页、`cart`购物车页、`user`个人中心页。再加一个`detail`宠物详情页和`order`订单列表页作为非tab页面。这样的结构视觉层级清晰，开发也方便。 自定义TabBar在宠物交易平台里是刚需，因为默认的TabBar只支持纯图标加文字，你没法做小红点提示（比如购物车数量角标）。微信官方提供了自定义TabBar的完整方案：在`app.json`里配置`"tabBar": {"custom": true}`，然后自己写一个`custom-tab-bar`组件，通过组件的`switchTab`方法做页面切换。 我做这个功能时踩过一个坑：**自定义TabBar切换页面后，选中状态的样式不会自动更新**。需要在每个tab页的`onShow`生命周期里手动调用`this.getTabBar().setData({selected: index})`去同步选中态。这个坑很典型，几乎每个人都会遇到，提前记下来能省半小时调试时间。 ### 3.2 首页数据渲染与上拉加载 宠物交易平台的首页承担着“一眼抓住用户”的任务，我建议的布局是：顶部搜索框（可跳转搜索页或做前端筛选）、轮播图（运营位）、分类快捷入口（图标宫格）、宠物列表（瀑布流卡片或双列网格）。 首页的数据渲染本质上是`wx.request`请求后端接口`GET /api/pet/list`，传`page`和`size`参数，后端做分页查询返回JSON。这里有两个提升体验的关键点： 一个是**下拉刷新和上拉加载更多**。微信小程序的`onPullDownRefresh`和`onReachBottom`是两个现成的页面事件，前者配合`wx.stopPullDownRefresh()`结束刷新动效，后者要实现触底防重复请求——用一个`loading`标志位，防止用户快速滑动时同一页数据被请求多次。 另一个是**图片懒加载**。宠物列表页图片多，不加懒加载的话首次打开会很卡。小程序里给`<image>`组件加`lazy-load="{{true}}"`属性即可，成本为零，收益明显。 ```javascript onReachBottom: function () { if (this.data.loading) return; if (this.data.page >= this.data.totalPages) return; this.setData({ loading: true }); wx.request({ url: apiBase + '/pet/list', data: { page: this.data.page + 1, size: 10 }, success: (res) => { const newList = res.data.data.records; if (newList.length === 0) { wx.showToast({ title: '没有更多了', icon: 'none' }); return; } this.setData({ petList: this.data.petList.concat(newList), page: this.data.page + 1, loading: false }); } }); }

注意：小程序端每次setData的数据量是有限制的，超过1MB会直接报错。列表类数据不要一次性全部塞进data里，分页加载天然就规避了这个限制。

3.3 宠物详情页与收藏/下单联动

宠物详情页的信息层级设计比列表页复杂，因为它承载的是“让用户掏钱”的转化任务。我的做法是：顶部图片区域用swiper组件轮播展示详情图，下面是标题和价格，再往下是基本信息表格（品种、年龄、性别、疫苗情况），然后是卖家信息和长图描述。

详情页一进来就干两件事：请求GET /api/pet/detail?id=xxx拿宠物数据和卖家信息；同时请求GET /api/favorite/check?petId=xxx判断当前用户是否已收藏这只宠物，用于渲染收藏按钮的实心/空心状态。

对应地，小程序里“立即购买”和“加入购物车”这两个按钮，逻辑有本质区别。加入购物车只需要往购物车表里插入一条记录（如果没有这张表的话用本地storage也行，但为了后续论文里数据流向完整，我建议做一张购物车表），而立即购买需要直接创建订单并跳转支付流程。

这里有一个课设答辩环节经常被问到的问题：“购物车和立即购买能不能共用一个下单接口？”我的答案是不建议。立即购买走“单品直购”逻辑，购物车走“多品合并结算”逻辑，虽然最后都要创建订单，但参数结构和业务语义有差异，分开写反而更清晰。如果你硬要合并，代码里会到处是if判断，答辩时自己都讲不清。

3.4 购物车与结算流程

购物车的实现逻辑其实不复杂，核心是“勾选计算”和“批量下单”。小程序的页面里维护一个cartList数组，每项包含宠物基础数据和一个checked布尔字段。用户勾选商品时，实时计算已选商品的总价，在底部固定栏显示。

结算按钮点击后，把勾选的商品数据拼装成订单参数，调用后端POST /api/order/create。后端收到请求后要做几件事：校验商品是否在售、计算订单总价（后端一定要重新计算价格，不能信任前端传来的价格，这是所有电商系统的铁律）、扣减库存（宠物交易平台里就是商品状态改为已售出）、生成订单号。

订单号生成我分享一个小技巧：可以用yyyyMMddHHmmss + 4位随机数拼成20位左右的字符串，既保证唯一性，又能方便在后台按时间范围查订单。别用自增id当订单号，会暴露平台的订单量，而且不美观。

3.5 微信支付接入方案

微信支付是很多课设项目最头疼的部分，因为个人主体的微信小程序没有权限开通微信支付，必须是企业主体才行。这里要根据你的实际情况分三条路来走：

• 你有企业资质：正常走微信支付流程，后端调用统一下单接口，拿到prepay_id，再返回给小程序端调起支付。
• 你没有企业资质（绝大多数学生的情况）：做一个“模拟支付”流程，用户点击支付按钮后，弹窗提示“模拟支付成功”，前端直接调后端接口通知订单已支付。论文里可以写“由于账户资质限制，本系统采用模拟支付机制，实际接入时只需替换支付SDK调用即可”。
• 使用微信云开发的云支付能力：这条路现在审核越来越严，个人建议直接走模拟支付，省时省力。

模拟支付不是偷懒，是在现有条件下保证项目完整度最高的做法。我在帮人改项目时，见过有人因为纠结微信支付资质问题，整个支付模块都没写，这才是真正的少了一个核心功能。宁可做模拟支付把订单流程走通，也不要留一个空壳按钮在那里。

4. 后端接口开发与部署环境搭建

4.1 后端框架搭建与统一返回结构

Spring Boot项目的初始化可以直接用Spring Initializr（start.spring.io）生成，选择Spring Web、MySQL Driver、MyBatis Plus或Spring Data JPA这几个依赖即可。国内网络环境下，建议把Maven仓库源换成阿里云镜像，否则依赖下载会慢到怀疑人生。

代码架构上我建议做四层：Controller（接收请求）、Service（业务逻辑）、Mapper/Repository（数据库操作）、Entity（数据实体）。这四层结构简单但很经典，论文里的架构图就照着这个画，答辩老师在投影上扫一眼就知道你的代码组织能力。

所有接口统一返回下面这个JSON结构，前端解析起来省事：

{ "code": 200, "message": "success", "data": { } }

public class Result<T> { private Integer code; private String message; private T data; public static <T> Result<T> success(T data) { Result<T> result = new Result<>(); result.setCode(200); result.setMessage("success"); result.setData(data); return result; } public static <T> Result<T> error(Integer code, String message) { Result<T> result = new Result<>(); result.setCode(code); result.setMessage(message); return result; } }

4.2 微信登录与JWT鉴权

微信小程序端的登录流程非常固定：小程序端调用wx.login()拿到临时凭证code，发给后端；后端拿着code去调用微信接口jscode2session，换取openid和session_key；用openid查数据库，如果用户不存在则自动注册新用户；最后生成一个JWT令牌返回给小程序端。

@PostMapping("/login") public Result<LoginVO> login(@RequestBody LoginDTO dto) { // 1. 调用微信接口获取openid String url = "https://api.weixin.qq.com/sns/jscode2session?appid=" + appId + "&secret=" + appSecret + "&js_code=" + dto.getCode() + "&grant_type=authorization_code"; String result = restTemplate.getForObject(url, String.class); JSONObject json = JSONObject.parseObject(result); String openid = json.getString("openid"); // 2. 根据openid查用户，不存在则注册 User user = userMapper.selectByOpenid(openid); if (user == null) { user = new User(); user.setOpenid(openid); user.setNickname("微信用户" + openid.substring(openid.length() - 6)); user.setRole(0); userMapper.insert(user); } // 3. 生成JWT令牌 String token = JwtUtil.generateToken(user.getId(), user.getRole()); LoginVO vo = new LoginVO(); vo.setToken(token); vo.setUserInfo(user); return Result.success(vo); }

JWT的好处是无状态，后端不需要存session，但要注意设置合理的过期时间——我一般设置7天，游客用户和正常用户的体验都平衡。小程序端拿到token后存到wx.setStorageSync('token', value)，之后每次请求在header里带Authorization: Bearer xxx。拦截器统一校验，校验不通过就返回401，前端收到401之后自动跳转登录页。

4.3 文件上传接口实现

宠物上架必须要传图片，所以文件上传接口是刚需。小程序的wx.uploadFile用法比较特殊，不是wx.request那种JSON请求，而是multipart表单形式。

后端用Spring Boot接收上传文件时，一般写这样一个接口：

@PostMapping("/upload") public Result<String> upload(@RequestParam("file") MultipartFile file) { if (file.isEmpty()) { return Result.error(500, "文件不能为空"); } String originalFilename = file.getOriginalFilename(); String suffix = originalFilename.substring(originalFilename.lastIndexOf(".")); // 用UUID重命名，防止文件名冲突 String newFileName = UUID.randomUUID().toString().replace("-", "") + suffix; // 按日期分目录存储 String datePath = new SimpleDateFormat("yyyyMMdd").format(new Date()); File dir = new File(uploadPath + "/" + datePath); if (!dir.exists()) { dir.mkdirs(); } file.transferTo(new File(dir.getAbsolutePath() + "/" + newFileName)); String url = "/upload/" + datePath + "/" + newFileName; return Result.success(url); }

这里有几个细节务必注意：一定要校验文件类型和后缀名，只允许jpg、png、gif、webp这些图片格式，防止用户上传木马脚本；一定要限制文件大小，在Spring Boot的配置里设置spring.servlet.multipart.max-file-size=10MB，不然一个超大文件就能把你服务器拖垮。

4.4 服务器部署全流程

部署环节是很多学生最陌生的环节，其实步骤非常固定。我以腾讯云轻量应用服务器（CentOS 7系统）为例，完整把流程走一遍：

第一步：服务器基础环境安装

# 更新系统包 yum update -y # 安装JDK 8（如果用的Java 8就装这个版本） yum install -y java-1.8.0-openjdk # 安装MySQL yum install -y mysql-server systemctl start mysqld systemctl enable mysqld # 安装Nginx yum install -y nginx systemctl start nginx systemctl enable nginx

第二步：初始化数据库

把本地的SQL文件上传到服务器，执行mysql -uroot -p < pet.sql导入数据。记得修改数据库密码，并且给应用创建一个专用账号，不要用root连数据库——这是基本安全意识，论文里写上也是加分项。

第三步：打包部署后端

本地用Maven执行mvn clean package -DskipTests打成jar包，上传到服务器/opt/app目录，然后启动：

nohup java -jar pet-platform.jar --server.port=8080 > app.log 2>&1 &

用nohup让程序在后台运行，app.log记录运行日志，排查问题全靠它。

第四步：配置Nginx反向代理

Nginx在这里做两件事：一是把https://你的域名/api/xxx请求转发到http://localhost:8080/api/xxx；二是配置HTTPS证书（证书可以在腾讯云或阿里云申请免费的）。配置如下：

server { listen 443 ssl; server_name yourdomain.com; ssl_certificate /etc/nginx/cert/yourdomain.pem; ssl_certificate_key /etc/nginx/cert/yourdomain.key; location /api/ { proxy_pass http://localhost:8080; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; } location /upload/ { proxy_pass http://localhost:8080; } }

第五步：小程序端配置域名

登录微信公众平台，在小程序后台的“开发管理-开发设置-服务器域名”里，把request合法域名配成你的HTTPS域名。这一步极其关键，很多项目部署后调用不了接口，十有八九就是域名没配或者协议不是HTTPS。

注意：微信小程序要求所有网络请求必须是HTTPS协议，HTTP协议在真机预览时会被直接拦截。本地开发时可以在开发者工具里勾选“不校验合法域名”，但真机测试和上线审核前一定要配上正式的HTTPS域名。

5. 常见问题与排查技巧实录

5.1 微信登录返回401或系统繁忙

这个问题的原因九成出在小程序的appid和后端的appSecret不匹配上。微信开发者工具有个默认的测试号appid，如果你用测试号开发，后端用的却是正式小程序的appSecret，jscode2session接口必然报错。排查思路是：确认小程序端的appid（在project.config.json里看）和后端配置的appid完全一致，并且对应同一个微信公众平台账号。

另一个容易忽视的点是：jscode2session接口的appid和secret都是在微信公众平台后台生成的，如果你还没注册小程序账号，只能用测试号或者游客模式跳过登录。课设里直接在登录接口加一个dev模式放行，线下演示时省去登录流程，也是常见的处理办法。

5.2 图片上传成功但访问404

这个问题在本地开发时尤其常见。你上传成功拿到了/upload/xxx.jpg这个路径，但浏览器访问localhost:8080/upload/xxx.jpg却404了。原因很简单：Spring Boot默认不把静态资源暴露在根路径下。解决办法是加一个WebMvcConfigurer配置：

@Configuration public class WebConfig implements WebMvcConfigurer { @Override public void addResourceHandlers(ResourceHandlerRegistry registry) { registry.addResourceHandler("/upload/**") .addResourceHandler("file:" + uploadPath + "/"); } }

如果你用了Nginx部署，还需要在Nginx里也配好对应的location /upload/块，两个地方漏一个都会404。

5.3 小程序端请求报ERR_CERT_COMMON_NAME_INVALID

这个报错是HTTPS证书和域名不匹配导致的。很多时候学生图省事，用IP地址访问接口，但小程序强制要求HTTPS且必须是备案过的域名，IP地址是没法配置SSL证书的。解决办法只有一个——买域名、备案、申请证书、配好HTTPS再上线。本地开发debug阶段可以暂时绕过，但上线的硬性条件绕不过去。

5.4 购物车数量与角标不同步

自定义TabBar上购物车的角标是很多人的“最后一块拼图”。这个问题的本质是数据同步：你在购物车页面改动了数据，TabBar角标必须同步更新。我的做法是封装一个全局的购物车数量刷新方法，在cart页面每次onShow时重新请求购物车数量接口，返回后设置到TabBar组件的数据里。

onShow: function () { this.loadCartList(); this.updateCartBadge(); }, updateCartBadge: function () { wx.request({ url: apiBase + '/cart/count', success: (res) => { const count = res.data.data; const tabBar = this.getTabBar(); if (tabBar) { tabBar.setData({ cartCount: count }); } } }); }

这个处理很实用，答辩现场如果评委老师点开购物车、退出去、再点进来看角标数字正确变了，这个小细节会让他们觉得你的项目工程化程度很高。

5.5 数据库连接池报错与表字段冲突

如果你用的是MySQL 8.0，驱动依赖mysql-connector-java的版本要选8.x，同时application.yml里连接串要加serverTimezone=Asia/Shanghai，否则会报时区错误。另外MySQL 8.0的默认认证插件是caching_sha2_password，老版本的驱动连不上，这两个问题叠加在一起，往往让新手以为是数据库装坏了，其实只差一个版本对齐。

6. 论文写作与答辩演示的加分细节

6.1 论文结构怎么搭

论文的结构虽然是学校给的模板，但核心章节的逻辑你可以自己优化。我建议的重点权重分配是：选题背景与意义（10%）、需求分析（20%）、系统设计（35%）、系统实现（25%）、测试与总结（10%）。系统设计这块，一定要包含架构图、功能模块图、数据库ER图、核心业务流程图（订单流程是个硬菜）这四张图，图比文字重要得多。

数据库设计部分，除了列出所有表结构，还要多写一段“设计说明”，解释为什么订单表和宠物表之间要用冗余的seller_id而非通过多表关联去查。这种“思考过程”的表述，比单纯罗列字段更能体现你的独立工作能力，也是答辩老师最爱点评的亮点。

6.2 答辩演示的路线规划

答辩现场演示的流程不要漫无目的地乱点，我建议按一条业务闭环走：登录进首页 -> 浏览宠物列表 -> 点击宠物详情 -> 收藏 -> 加入购物车 -> 结算下单 -> 模拟支付 -> 到订单列表查看 -> 卖家端宠物上下架操作。这条链路正好覆盖了你系统的所有核心功能，每一步都对应你论文里的一块设计，展示完这一圈，相当于把你的毕设从头到尾讲明白了。

演示之前务必要做两轮全流程演练：一轮在微信开发者工具上走一遍，一轮真机预览走一遍。两条路的网络环境不同，最容易暴露接口域名配置和HTTPS证书的问题。千万不要等答辩当天早上才发现数据图片加载不出来，那种尴尬真的扛不住。

6.3 源码整理的工程规范

最后说一下源码交付这件事。很多学生的“源码包”就是整个项目工程文件夹直接打包，里面各种.idea、target、node_modules、__pycache__目录散落一地，导师和你自己日后翻起来都头疼。建议交付前做一次整理：后端去掉target目录，前端去掉miniprogram_npm（如果是原生小程序）之类临时产物，附上一份根目录README.md，写清楚项目简介、技术栈、启动步骤、默认账号密码、部署说明五个部分。

这份README的价值在你自己身上也会体现——等你过一个月再翻这个项目，你会感谢自己当时写了这份文档。我见过太多人三个月后打开自己写的项目，面对一堆文件回忆不起当时的思路，那真是纯纯的原地浪费时间。

源码头文件不要随便删，但有些文件确实必须删：所有包含数据库密码的配置文件（尤其是不小心把真实的云数据库密码传上git的）、本地绝对路径配置、个人AppSecret配置。涉及隐私的配置项，用application-example.yml之类的模板方式提供，让别人填自己的值。这个小技巧能让你避免很多不必要的麻烦。

还有一个建议：给源码包里的关键模块加上必要的注释，不用多，核心Service层的类注释加上方法注释就够了。很多导师会翻阅源码，注释规范的项目，平时分会高一个档。论文里不用体现注释，但导师翻到时好感度直接拉满。

我做这个宠物交易平台项目时最深刻的体会是：这类项目的难点从来不在单个技术点上，而是在于你如何把“登录-浏览-交易-订单”这条数据链路完整地打通，并在这个过程中做出有说服力的工程决策。微信小程序端的坑、后端鉴权的坑、部署上线的坑，每一步踩过去之后才会真正理解为什么行业里会形成那些约定俗成的规范。希望这份实操经验能帮你少走几个弯路，项目顺利过关。