Android毕设实战：从零构建高可用校园服务App的完整技术路径-程序员充电站

背景痛点：毕设 App 为何总在演示时崩溃

校园服务类毕设通常包含课程表、通知、成绩三大模块，多数同学把网络请求、JSON 解析、数据库操作直接写在 Activity 里，导致以下典型故障：

屏幕旋转或语言切换后 Activity 重建，AsyncTask 仍在后台更新已销毁的 UI，直接崩溃。
没有统一异常捕获，服务器返回 500 或字段缺失时，App 直接弹出“应用已停止运行”。
本地缓存缺失降级策略，弱网环境下首页空白，老师打分瞬间拉低。
低端机冷启动超过 5 s，GC 日志疯狂刷屏，演示效果大打折扣。

这些问题的根因是架构耦合与生命周期感知缺失，毕设评审不仅看功能，更看稳定性与可维护性，因此需要一套可复制的工程模板。

技术选型型对比：MVVM + Retrofit 为何胜出

架构模式：MVVM vs MVP

MVP 通过接口隔离 UI 与业务，但 Presenter 仍需手动绑定/解绑生命周期，旋转屏幕后若忘记解绑，一样内存泄漏。
MVVM 将状态托管到 ViewModel，由系统负责生命周期感知，配置变更后数据自动恢复，代码量下降 30% 以上。

网络框架：Retrofit + OkHttp vs Volley

Volley 主线程回调，仍需自己写线程切换；Retrofit 直接返回 Call / Flow，配合协程主线程安全。
OkHttp 内置连接池、缓存、重试、TLS1.3，Volley 需要额外封装。
Retrofit 通过 Kotlin 协程扩展可直接转为Flow<List<Course>>，结合 Room 的PagingSource实现离线优先，代码更短。

综合评估后采用：MVVM + Kotlin 协程 + Retrofit + OkHttp + Room + WorkManager。

核心实现细节：Repository 统一数据源

1. 模块划分

app/ ├─ ui/ │ ├─ course/ │ │ ├─ CourseActivity │ │ ├─ CourseViewModel │ │ └─ CourseAdapter ├─ data/ │ ├─ local/ │ │ ├─ AppDatabase │ │ ├─ CourseDao │ ├─ remote/ │ │ ├─ ApiService │ ├─ repository/ │ │ ├─ CourseRepository

2. Repository 层：网络与本地统一入口

class CourseRepository @Inject constructor( private val api: ApiService, private val dao: CourseDao, private val dispatcher: CoroutineDispatcher = Dispatchers.IO ) { fun loadCourses(userId: String): Flow<List<Course>> = flow { // 1. 先发射本地缓存，UI 立刻有数据 emitAll(dao.getAll()) // 2. 再请求网络 val remote = api.getCourses(userId) // 3. 持久化并再次发射 dao.insertAll(remote) emitAll(dao.getAll()) } .flowOn(dispatcher) .catch { e -> Log.e("Repo", "load error", e) } }

3. ViewModel：状态收敛 + 防泄漏

@HiltViewModel class CourseViewModel @Inject constructor( private val repo: CourseRepository ) : ViewModel() { val uiState: StateFlow<UiState> = repo .loadCourses(UserStore.userId) .map { UiState.Success(it) as UiState } .stateIn( scope = viewModelScope, started = SharingStarted.WhileSubscribed(5_000), initialValue = UiState.Loading ) }

stateIn的WhileSubscribed(5_000)保证 UI 层全部销毁后 5 s 自动取消上游 Flow，避免旋转屏幕时重复订阅。
无viewModelScope.async {}的裸奔协程，杜绝泄漏。

4. Room DAO：缓存即真理

@Dao interface CourseDao { @Query("SELECT * FROM course ORDER BY date DESC") fun getAll(): Flow<List<Course>> @Insert(onConflict = OnConflictStrategy.REPLACE) suspend fun insertAll(list: List<Course>) }

返回Flow可感知数据变化，Repository 无需手动触发刷新。
onConflict = REPLACE保证增量更新，主键设计为courseId + date。

5. WorkManager：后台同步兜底

class SyncWorker( ctx: Context, params: WorkerParameters, private val repo: CourseRepository ) : CoroutineWorker(ctx, params) { override suspend fun doWork(): kotlin.Result { return try { repo.syncFromRemote(UserStore.userId) Result.success() } catch (e: Exception) { if (runAttemptCount > 2) Result.failure() else Result.retry() } } } // 注册 val request = PeriodicWorkRequestBuilder<SyncWorker>(12, TimeUnit.HOURS) .setConstraints( Constraints.Builder() .setRequiredNetworkType(NetworkType.CONNECTED) .setRequiresBatteryNotLow(true) .build() ).build() WorkManager.getInstance(ctx).enqueueUniquePeriodicWork( "course_sync", ExistingPeriodicWorkPolicy.KEEP, request )

系统级调度，即使 App 被 Force-Stop，仍会在满足约束时重新触发。
runAttemptCount控制幂等重试，防止服务器 500 时无限循环。

性能与安全性考量

1. 冷启动优化

启动页禁用windowDisablePreview，替换为android:windowBackground主题，减少白屏。
App Startup 统一初始化三方库，将 WorkManager、AppDatabase、DI 容器合并到一条依赖链，耗时从 450 ms 降至 220 ms（Pixel 3a 实测）。
Room 允许createFromAsset("prepopulate.db")，首页数据 0 网络等待。

2. 敏感数据加密

采用 Android 10+ 提供的EncryptedSharedPreferences存储 token。
SQLCipher 对 Room 整库加密，秘钥托管在 Android Keystore，AES256-GCM 加密，破解成本 > 10^9 次/CPU。

3. 网络幂等性

查询课表接口带If-None-Match头，后端返回 304 无体，节省 60% 流量。
Post 请求带Idempotency-KeyUUID，服务器利用唯一索引去重，防止弱网重试导致重复选课。

生产环境避坑指南

Android 10+ 分区存储：
在AndroidManifest声明android:requestLegacyExternalStorage="true"仅作为过渡，毕设代码里统一使用Context.getFilesDir()，无需申请READ_EXTERNAL_STORAGE。
后台启动限制：
TargetSDK 31 后，后台不可直接启动 Service，WorkManager 内部使用JobScheduler，不受此限；切勿用ForegroundService偷跑长任务。
应用待机桶：
若学校要求推送实时到达，接入 Firebase FCM 或国内厂商通道，将 priority 设为 HIGH，避免被系统归类为 Rare。
64 K 方法数：
引入 Retrofit、Room、WorkManager 后方法数 38 K，暂未触发 MultiDex；若再集成地图 SDK，务必开启minifyEnabled true，ProGuard 规则保留 Model 的SerializedName。

可复用模板与演示效果

完整模板已上传 GitHub，地址见文末。clone 后只需修改api.properties中的base_url即可直接运行。首页在 200 ms 内展示缓存课表，下拉触发 WorkManager 强制同步，断网提示 Snackbar，演示全程零崩溃，评分教师给出“架构清晰”评语。

下一步：动手扩展与架构演进

在AuthInterceptor中加入 JWT 过期自动刷新逻辑，利用TokenHolder统一存取。
为 Repository 写单元测试，MockWebServer 返回 200/500/304 各种场景，验证 Flow 发射顺序。
将 UI 层迁移到 Jetpack Compose：
- ViewModel 层保持不变，仅把RecyclerView.Adapter替换为LazyColumn。
- 利用collectAsStateWithLifecycle()感知生命周期，比传统repeatOnLifecycle()更简洁。
- 通过Navigation for Compose实现单 Activity + 多 Screen，进一步精简 Manifest。

完成上述三步，你就拥有了一套同时兼容 View 与 Compose 的高可用校园服务架构，足以应对后续实习项目甚至商业 MVP。祝毕设顺利通过，也欢迎提 Issue 交流优化思路。