智慧医疗挂号App毕设源码：AndroidStudio项目复现与避坑指南

简介：这份资源是面向高校计算机相关专业毕业设计的完整安卓项目案例，基于AndroidStudio与sqlite数据库开发，包含安卓客户端与服务器端源代码及项目文档，适合正在准备毕业设计、需要智慧医疗或健康管理类选题的学生参考与二次开发。项目围绕医院预约挂号场景，实现了病人注册登录、流行病学调查表填写、核酸检查预约与记录查询、新冠疫苗预约与记录查询、门诊预约与记录查询，以及医保卡绑定、就诊卡创建管理等模块，功能链路较为完整。压缩包共115个文件，以40个xml布局、14个java源码、30个jpg与16个png界面素材为主，另含gradle构建脚本、项目报告docx及说明文档，整体约4.87MB，结构清晰便于按模块查阅。目前已有503人学习下载，可作为毕业设计选题落地、功能拆解与代码实现的实用参考。

1. 从一份能跑通的智慧医疗挂号 App 源码说起

很多同学做毕业设计时，选题定了“智慧医疗医院预约挂号”，结果卡在第一步：AndroidStudio 工程跑不起来，服务器端和客户端对不上，数据库建表语句缺失，最后只能拿别人的截图凑论文。我手上这份资源就是针对这个场景的——一套基于 AndroidStudio 开发的智慧医疗医院预约挂号 App，包含安卓客户端、安卓服务器端、源代码和项目文档。它解决的不是“从零学安卓”的问题，而是让你在有限时间内拿到一个结构完整、能编译、能演示、能写进论文的工程。适合正在做医疗类 App 毕设、需要快速理解挂号业务闭环、或者想拿一套真实项目练手 Android 网络编程的人。下面我按实际拆包和复现的顺序，把这份资源里里外外讲清楚。

2. 工程结构与技术栈拆解：先看清客户端和服务端怎么分工

2.1 客户端模块划分与关键文件定位

拿到源码后别急着点 Run，先看目录。常见做法是客户端用 AndroidStudio 默认的 Gradle 结构，app/src/main/java下按包名分几个模块：activity放页面，adapter放列表适配器，bean或entity放数据模型，network或utils放网络请求封装，db放本地 SQLite 操作。这份资源里挂号业务的核心页面通常包括：登录注册、科室列表、医生列表、医生详情、预约时间选择、预约记录、个人中心。服务器端如果是安卓服务器端，一般是一个独立的 Android 工程或者一个 Java Web 工程，用 Servlet 或 Spring Boot 暴露接口，数据库用 MySQL 或 SQLite。

我一般会先找AndroidManifest.xml，看注册了哪些 Activity，这样能快速画出页面跳转关系。然后找build.gradle里的依赖，确认网络库是 OkHttp 还是 Retrofit，图片加载是 Glide 还是 Picasso，数据库是原生 SQLite 还是 Room。这些信息决定了你后续改代码的方向。如果依赖里有okhttp和gson，那网络层大概率是手动拼 JSON；如果有retrofit和converter-gson，那就是接口式调用。两种写法在调试时排查点完全不同。

# 查看客户端依赖，快速判断技术栈 cd YourProject/app cat build.gradle | grep -E "implementation|api"

这段命令的作用是过滤出依赖行，避免你在一大堆配置里翻找。重点看implementation后面的库名和版本号。如果版本号带+号，比如com.squareup.okhttp3:okhttp:4.+，说明作者没有锁死版本，你本地编译时可能拉到最新版导致 API 不兼容，这是第一个要改的地方，建议改成固定版本。

2.2 服务器端接口设计与数据库表关系

服务器端如果是安卓工程，通常用HttpURLConnection或 OkHttp 写一个简单的 HTTP 服务，监听某个端口，接收客户端请求后查数据库返回 JSON。如果是 Java Web 工程，那就在web.xml或 Spring Boot 的Controller里找接口路径。挂号业务的核心表一般有四张：用户表、科室表、医生表、预约记录表。用户表存账号密码和基本信息；科室表存科室名称和描述；医生表存医生姓名、职称、所属科室、简介；预约记录表存用户 ID、医生 ID、预约时间段、预约状态。

你需要重点检查外键关系和查询语句。比如“根据科室查医生”这个接口，SQL 可能是SELECT * FROM doctor WHERE department_id = ?。如果客户端传的科室 ID 是字符串，服务器端用 int 接收，就会查不到数据。这种类型不匹配是毕设项目里最常见的翻车点之一。我一般会先把数据库建表语句找出来，在本地 MySQL 里执行一遍，然后手动插入几条测试数据，再用 Postman 或浏览器直接访问接口，确认返回的 JSON 结构。

-- 典型的预约记录表建表语句，注意字段类型和索引 CREATE TABLE appointment ( id INT PRIMARY KEY AUTO_INCREMENT, user_id INT NOT NULL, doctor_id INT NOT NULL, appoint_time VARCHAR(50) NOT NULL, status INT DEFAULT 0 COMMENT '0待确认 1已确认 2已取消', create_time DATETIME DEFAULT CURRENT_TIMESTAMP, INDEX idx_user (user_id), INDEX idx_doctor (doctor_id) );

这段 SQL 里status用整数表示状态，客户端解析时就要做映射，不能直接显示数字。appoint_time用字符串存时间段，比如“2025-06-01 09:00-09:30”，好处是简单，坏处是无法按时间范围查询。如果论文里要写“智能排班”或“时间冲突检测”，这个设计就不够用，需要改成两个DATETIME字段分别存开始和结束时间。索引idx_user和idx_doctor是为了加快按用户或医生查询预约记录的速度，数据量小时感觉不到，但答辩演示时如果数据多，没索引会明显卡顿。

2.3 客户端与服务端的通信协议对齐

客户端发请求、服务器端返 JSON，这个链条里最容易出问题的是字段名和编码。比如客户端用 Gson 解析，实体类里字段叫userName，服务器端返回的 JSON 里叫user_name，那就解析不出来，对象为 null，页面一片空白。解决办法是在实体类字段上加@SerializedName("user_name")注解，或者统一命名风格。我一般会先抓一个接口的返回包，把 JSON 结构复制下来，用在线工具生成实体类，这样字段名绝对对得上。

另一个坑是中文编码。服务器端返回中文时，如果没设置response.setCharacterEncoding("UTF-8")，客户端收到就是乱码。现象是科室名称显示成问号或方块。解决方式是在服务器端输出流之前设置编码，客户端解析时也用 UTF-8。如果用的是 OkHttp，默认就是 UTF-8，但服务器端不设置照样乱码。这个点很小，但答辩演示时出现乱码非常尴尬，建议提前改好。

3. 本地复现全流程：从导入工程到跑通一次挂号

3.1 环境准备与工程导入的版本匹配

先确认你本地的 AndroidStudio 版本和工程里的 Gradle 插件版本是否匹配。常见做法是打开工程根目录的build.gradle，看com.android.tools.build:gradle的版本号。如果是 4.x 的插件，用 AndroidStudio 4.x 或 2020 版打开最稳；如果是 7.x 的插件，就需要 AndroidStudio 2021 以上。版本不匹配时，AndroidStudio 会提示升级 Gradle 插件，点“升级”后可能引入新的编译错误，所以最好先查一下工程原本用的版本。

# 查看工程使用的 Gradle 插件版本 cd YourProject cat build.gradle | grep "com.android.tools.build:gradle"

如果输出是com.android.tools.build:gradle:4.1.2，那你就用 AndroidStudio 4.1 或 4.2 打开，不要用最新版。导入后如果卡在 “Gradle sync”，检查gradle-wrapper.properties里的distributionUrl，看它指向的 Gradle 版本是否能在本地下载。如果下载慢，可以手动下载对应版本的 Gradle 压缩包，放到本地缓存目录，或者改成国内镜像地址。这一步没有技术含量，但卡住的人最多。

3.2 数据库初始化与服务器端启动

服务器端如果是 Java Web 工程，先找src下的 SQL 文件或db.sql，在 MySQL 里建库建表。然后改数据库连接配置，通常在jdbc.properties或application.yml里，把 URL、用户名、密码改成你本地的。如果是安卓服务器端，数据库可能是 SQLite，那就把.db文件放到指定目录，或者让程序首次运行时自动建表。

// 典型的 JDBC 连接配置，注意 URL 里的参数 String url = "jdbc:mysql://localhost:3306/hospital?useSSL=false&serverTimezone=UTC&characterEncoding=utf8"; String username = "root"; String password = "your_password"; Connection conn = DriverManager.getConnection(url, username, password);

这段代码里useSSL=false是关闭 SSL 连接，本地测试可以这样，否则可能报证书错误。serverTimezone=UTC是设置时区，不设置的话 MySQL 8 以上会报时区异常。characterEncoding=utf8保证中文不乱码。这三个参数是血泪经验，少一个都可能启动失败。改完配置后，先启动服务器端，看控制台有没有报错，确认端口监听成功。

3.3 客户端网络地址配置与真机调试

客户端里通常会有一个Constants.java或ApiConfig.java，里面定义了服务器地址。如果你用模拟器，服务器在本地电脑上，地址要写10.0.2.2而不是localhost，因为模拟器里的 localhost 指向模拟器自己。如果你用真机调试，手机和电脑连同一个 Wi-Fi，地址写电脑的局域网 IP，比如192.168.1.100。这个地址写错，现象就是请求超时或连接被拒绝。

// 客户端网络地址配置，根据调试方式二选一 public class ApiConfig { // 模拟器访问本地服务器 public static final String BASE_URL = "http://10.0.2.2:8080/hospital/"; // 真机访问本地服务器，替换成你电脑的局域网 IP // public static final String BASE_URL = "http://192.168.1.100:8080/hospital/"; }

改完地址后，先跑登录接口。如果登录成功，说明网络链路通了。然后依次测试科室列表、医生列表、预约提交。每测一个接口，看客户端日志里的请求 URL 和返回数据。如果返回 404，检查服务器端接口路径和客户端拼接的路径是否一致；如果返回 500，看服务器端控制台的异常堆栈。我一般会在服务器端每个接口入口加一行日志，打印请求参数，这样排查时一目了然。

4. 避坑与常见问题排查：那些答辩前容易翻车的地方

4.1 现象：登录后科室列表空白，日志显示 JSON 解析异常

原因通常是服务器端返回的 JSON 字段和客户端实体类不匹配，或者返回了 HTML 错误页而不是 JSON。比如服务器端抛异常后返回了一个 500 错误页，客户端用 Gson 解析 HTML 就会报JsonSyntaxException。解决方式是先看客户端日志里打印的原始响应内容，如果是 HTML，就去服务器端查异常；如果是 JSON 但字段对不上，用@SerializedName注解对齐字段名。

4.2 现象：预约提交成功但数据库里没有记录

原因可能是服务器端事务没提交，或者客户端传的参数名和服务器端接收的参数名不一致。比如客户端传doctorId，服务器端用request.getParameter("doctor_id")接收，那就取不到值。解决方式是打印服务器端接收到的参数，确认参数名一致。另外检查 JDBC 代码里有没有conn.commit()，如果用了事务但没提交，数据不会入库。

4.3 现象：真机调试时请求超时，模拟器却正常

原因是真机和电脑不在同一网段，或者电脑防火墙拦截了端口。解决方式是确认手机和电脑连同一个 Wi-Fi，查看电脑的局域网 IP，在手机浏览器里直接访问http://电脑IP:端口/接口路径，如果能访问说明网络通，不能访问就检查防火墙或换端口。另外有些校园网或公司网络隔离了设备间通信，这种情况只能用模拟器或换网络环境。

4.4 现象：AndroidStudio 编译报错 “Duplicate class” 或 “Program type already present”

原因是依赖库版本冲突，比如同时引入了两个不同版本的 OkHttp，或者 AndroidX 和 support 库混用。解决方式是在build.gradle里用exclude排除重复依赖，或者统一升级到 AndroidX。如果项目原本用的是 support 库，可以在gradle.properties里加android.useAndroidX=true和android.enableJetifier=true，让 AndroidStudio 自动迁移。

4.5 现象：答辩演示时 App 闪退，日志显示 “NetworkOnMainThreadException”

原因是在主线程里做了网络请求。Android 4.0 以后不允许在主线程进行网络操作。解决方式是把网络请求放到子线程里，或者用 OkHttp 的异步请求enqueue，或者用AsyncTask。如果代码里直接写了HttpURLConnection的getInputStream()在主线程，就会闪退。这个坑在毕设代码里非常常见，建议全局搜索网络请求代码，确认都在子线程或异步回调里。

5. 进阶改造与验证：让这份毕设经得起追问

5.1 把预约时间冲突检测加进去

原始项目可能只是简单插入预约记录，没有检测同一医生同一时间段是否已被预约。你可以在服务器端提交预约前，先查一下appointment表里有没有相同doctor_id和appoint_time且status不为“已取消”的记录。如果有，就返回“该时间段已被预约”。这个逻辑用一条 SQL 就能实现，但能让你的论文多一个技术亮点。

-- 查询某医生某时间段是否已有有效预约 SELECT COUNT(*) FROM appointment WHERE doctor_id = ? AND appoint_time = ? AND status != 2;

这条 SQL 返回数量大于 0 就说明冲突。参数?分别对应医生 ID 和时间段字符串。注意status != 2排除了已取消的预约，否则用户取消后别人也约不上。这个细节在答辩时如果被问到，能体现你对业务状态的理解。

5.2 用 Postman 做接口回归验证

改造完服务器端后，不要每次都打开 App 测。用 Postman 建一个集合，把登录、查科室、查医生、提交预约、查预约记录这几个接口都存进去，每次改完代码跑一遍集合。这样能快速确认服务器端逻辑没问题，再把问题定位到客户端。Postman 里可以设置环境变量，把base_url和token抽出来，切换环境时不用改每个请求。

这张表建议你直接抄进论文的“系统接口设计”章节，比纯文字描述清晰得多。参数名要和代码里完全一致，否则 Postman 测试通过但 App 请求失败，说明客户端拼参数有问题。

5.3 日志与断点配合定位问题

AndroidStudio 的 Logcat 和断点调试要配合用。网络请求前打一行日志输出 URL 和参数，返回后打一行日志输出响应码和响应体前 200 个字符。这样即使不打断点，也能从日志看出请求是否发出、服务器是否返回、返回内容是什么。如果日志显示请求发出了但没返回，就在服务器端打断点，看请求有没有到达。如果到达了但没返回，就在数据库操作处打断点，看 SQL 有没有执行、结果是什么。

从那以后我每次拿到一份毕设源码，都强制走一遍“先看依赖版本、再跑服务器端、最后调客户端”的流程，绝不跳过任何一步。希望这份拆解能帮你把这份智慧医疗挂号 App 顺利跑起来，写进论文，通过答辩。

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