汤君健1. 项目背景与核心需求
在大学校园里，选修课是拓展学生知识面的重要途径，但长期以来存在一个痛点：不同年级、不同专业的学生在选修同一门课程时，缺乏有效的经验交流渠道。传统的方式是通过BBS论坛或微信群分享，但这些平台要么过于分散，要么信息容易被淹没。
这正是我们设计这款"选修课技能分享APP"的初衷。作为一个基于SpringBoot后端和Android客户端的移动应用，它专门针对大学生选修课场景，提供课程评价、学习资料共享、技能交流等核心功能。与市面上通用的社交APP不同，我们的设计聚焦三个关键需求：
- 课程信息的结构化呈现：将零散的课程评价转化为可搜索、可比较的标准化数据
- 学习资源的定向分享：建立课程与资料的强关联，避免群聊中的资源混杂
- 同课校友的精准连接：基于选修课记录自动匹配有共同课程背景的用户
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 技术架构设计
2.1 整体技术栈选型
后端服务：
- 框架：SpringBoot 2.7 + Spring MVC
- 数据库：MySQL 8.0（关系型）+ Redis 7.0（缓存）
- 文件存储：MinIO自建对象存储
- 消息队列：RocketMQ 4.9（异步通知）
- 安全框架：Spring Security + JWT
Android客户端：
- 开发环境：Android Studio Electric Eel
- 最低兼容：Android 8.0（API 26）
- 网络通信：Retrofit2 + OkHttp3
- 图片加载：Glide 4.13
- 本地数据库：Room 2.4
提示：选择RocketMQ而非ActiveMQ是考虑到选修课场景下可能出现的峰值流量（如选课季的集中访问），RocketMQ的分布式特性更适合这种突发流量场景。
2.2 前后端交互设计
采用经典的RESTful API风格，但针对移动端特性做了以下优化：
-
数据分页策略：
- 默认分页大小：15条/页
- 滚动加载阈值：剩余3条时触发预加载
- 分页元数据格式：
json复制{ "data": [...], "pagination": { "current_page": 1, "total_pages": 5, "has_more": true } }
-
缓存策略矩阵：
| 数据类型 | 缓存层级 | 过期时间 | 更新触发条件 |
|---|---|---|---|
| 课程基本信息 | Redis | 24h | 管理员修改 |
| 课程评价 | 本地+Redis | 1h | 新增评价 |
| 用户资料 | 本地+Redis | 30min | 用户主动更新 |
| 热门资源 | Redis | 2h | 定时任务计算 |
3. 核心功能实现细节
3.1 课程卡片动态生成
课程卡片是APP的核心UI组件，其数据来源于后端聚合服务：
java复制// SpringBoot服务端聚合逻辑示例
@GetMapping("/courses/{id}/card")
public ResponseEntity<CourseCardVO> getCourseCard(@PathVariable Long id) {
// 并行获取基础信息与统计信息
CompletableFuture<CourseBasicInfo> basicFuture = CompletableFuture
.supplyAsync(() -> courseService.getBasicInfo(id));
CompletableFuture<CourseStats> statsFuture = CompletableFuture
.supplyAsync(() -> statsService.getCourseStats(id));
// 合并结果
return CompletableFuture.allOf(basicFuture, statsFuture)
.thenApply(v -> {
CourseCardVO card = new CourseCardVO();
card.setBasic(basicFuture.join());
card.setStats(statsFuture.join());
return ResponseEntity.ok(card);
}).exceptionally(e ->
ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).build()
).join();
}
Android端采用组合式布局实现卡片UI：
xml复制<!-- 课程卡片核心布局结构 -->
<androidx.cardview.widget.CardView>
<ConstraintLayout>
<!-- 头部区域 -->
<ImageView app:imageUrl="@{card.basic.coverUrl}"/>
<TextView app:text="@{card.basic.title}"/>
<!-- 评分区域 -->
<RatingBar app:rating="@{card.stats.avgRating}"/>
<TextView app:text="@{String.format('%.1f', card.stats.avgRating)}"/>
<!-- 标签区域 -->
<FlowLayout>
<TextView app:text="@{tag}"
forEach="tag in card.basic.tags"/>
</FlowLayout>
<!-- 底部操作区 -->
<ImageButton app:icon="@drawable/ic_share"/>
<ImageButton app:icon="@drawable/ic_favorite"/>
</ConstraintLayout>
</androidx.cardview.widget.CardView>
3.2 资料分享的断点续传
考虑到学生可能上传大体积课件（如视频教程），我们实现了基于HTTP Range请求的断点续传：
- 服务端实现：
java复制@PostMapping("/resources/upload")
public ResponseEntity<UploadToken> startUpload(
@RequestParam String filename,
@RequestParam long fileSize) {
String objectName = "resources/" + UUID.randomUUID();
String uploadId = minioClient.initMultiPartUpload(objectName);
// 生成分片上传凭证
UploadToken token = new UploadToken();
token.setUploadId(uploadId);
token.setObjectName(objectName);
token.setChunkSize(5 * 1024 * 1024); // 5MB分片
token.setExpiresAt(System.currentTimeMillis() + 3600000);
return ResponseEntity.ok(token);
}
@PutMapping("/resources/upload/{uploadId}/{partNumber}")
public ResponseEntity<Void> uploadPart(
@PathVariable String uploadId,
@PathVariable int partNumber,
@RequestPart MultipartFile chunk) {
// 验证分片序号有效性
// 存储分片数据
// 返回ETag标识
}
- Android端实现关键点：
kotlin复制class ResumableUploader(
private val file: File,
private val api: UploadAPI
) {
suspend fun upload(): Result<Unit> = withContext(Dispatchers.IO) {
val totalSize = file.length()
val token = api.startUpload(file.name, totalSize).getOrThrow()
val chunkSize = token.chunkSize
val totalParts = ceil(totalSize.toDouble() / chunkSize).toInt()
val inputStream = FileInputStream(file)
try {
(0 until totalParts).map { partNumber ->
val offset = partNumber * chunkSize
val actualSize = min(chunkSize, totalSize - offset)
val buffer = ByteArray(actualSize)
inputStream.channel.use { channel ->
channel.position(offset)
channel.read(ByteBuffer.wrap(buffer))
}
async {
api.uploadPart(
uploadId = token.uploadId,
partNumber = partNumber + 1,
chunk = buffer.toRequestBody()
)
}
}.awaitAll()
api.completeUpload(token.uploadId)
Result.success(Unit)
} catch (e: Exception) {
Result.failure(e)
}
}
}
注意：Android 10+需要处理Scoped Storage权限问题，建议在Manifest中声明：
xml复制<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" /> <application android:requestLegacyExternalStorage="true" ...>
4. 性能优化实践
4.1 图片加载三级缓存
针对课程封面、用户头像等图片资源，我们设计了复合缓存策略：
-
内存缓存：使用LruCache，分配1/8可用内存
kotlin复制val memoryCache = LruCache<String, Bitmap>((Runtime.getRuntime().maxMemory() / 8).toInt()) -
磁盘缓存：自定义基于Room的缓存仓库
kotlin复制@Entity data class ImageCache( @PrimaryKey val url: String, val bitmapBytes: ByteArray, val lastAccessed: Long ) @Dao interface ImageCacheDao { @Query("SELECT * FROM image_cache WHERE url = :url") suspend fun get(url: String): ImageCache? @Insert(onConflict = OnConflictStrategy.REPLACE) suspend fun insert(cache: ImageCache) @Query("DELETE FROM image_cache WHERE lastAccessed < :threshold") suspend fun cleanup(threshold: Long) } -
网络加载：带优先级的OkHttp请求
kotlin复制val loader = ImageLoader.Builder(context) .availableMemoryPercentage(0.25) .crossfade(true) .networkCachePolicy(CachePolicy.ENABLED) .priority(NetworkPriority.HIGH) .build()
4.2 列表渲染优化
课程列表采用DiffUtil实现高效更新：
kotlin复制class CourseDiffCallback(
private val oldList: List<CourseItem>,
private val newList: List<CourseItem>
) : DiffUtil.Callback() {
override fun getOldListSize() = oldList.size
override fun getNewListSize() = newList.size
override fun areItemsTheSame(oldPos: Int, newPos: Int) =
oldList[oldPos].id == newList[newPos].id
override fun areContentsTheSame(oldPos: Int, newPos: Int) =
oldList[oldPos] == newList[newPos]
override fun getChangePayload(oldPos: Int, newPos: Int): Any? {
// 精细化的局部更新逻辑
}
}
// 在Adapter中的使用
fun submitNewList(newList: List<CourseItem>) {
val diffResult = DiffUtil.calculateDiff(CourseDiffCallback(currentList, newList))
this.currentList = newList
diffResult.dispatchUpdatesTo(this)
}
5. 安全防护方案
5.1 接口防刷策略
针对评价提交、点赞等敏感操作，实施多维度防护：
-
设备指纹生成：
kotlin复制fun generateDeviceId(context: Context): String { val telephony = context.getSystemService(Context.TELEPHONY_SERVICE) as TelephonyManager val androidId = Settings.Secure.getString( context.contentResolver, Settings.Secure.ANDROID_ID ) return try { val deviceSpecific = telephony.deviceId ?: "" val hash = MessageDigest .getInstance("SHA-256") .digest("$androidId$deviceSpecific".toByteArray()) Base64.encodeToString(hash, Base64.NO_WRAP) } catch (e: Exception) { UUID.randomUUID().toString() } } -
行为风控规则示例：
| 风险行为 | 检测条件 | 防护措施 |
|---|---|---|
| 刷评价 | 同一课程1分钟内≥3条评价 | 要求图形验证码 |
| 异常点赞 | 每秒点赞操作≥5次 | 临时封禁15分钟 |
| 爬虫行为 | 接口调用频率异常 | 人机验证挑战 |
5.2 敏感数据保护
-
客户端数据加密：
kotlin复制fun encryptLocalData(plainText: String, key: SecretKey): String { val cipher = Cipher.getInstance("AES/GCM/NoPadding") val iv = ByteArray(12).also { SecureRandom().nextBytes(it) } cipher.init(Cipher.ENCRYPT_MODE, key, GCMParameterSpec(128, iv)) val cipherText = cipher.doFinal(plainText.toByteArray()) return Base64.encodeToString(iv + cipherText, Base64.NO_WRAP) } -
传输层安全增强：
kotlin复制val okHttpClient = OkHttpClient.Builder() .sslSocketFactory( createSSLSocketFactory(), trustManager ) .hostnameVerifier { hostname, session -> // 证书绑定验证逻辑 } .addInterceptor(HeaderInterceptor()) .build()
6. 发布与监控
6.1 应用发布流程
-
构建变体配置：
gradle复制android { flavorDimensions "env" productFlavors { dev { dimension "env" applicationIdSuffix ".dev" resValue "string", "app_name", "选修课分享(Dev)" } prod { dimension "env" resValue "string", "app_name", "大学选修课分享" } } buildTypes { release { minifyEnabled true proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro' } } } -
自动化发布脚本：
bash复制#!/bin/bash ./gradlew clean ./gradlew assembleProdRelease apksigner sign \ --ks release.jks \ --ks-key-alias mykey \ --out app-prod-release-signed.apk \ app-prod-release-unsigned.apk bundletool build-apks \ --bundle=app.aab \ --output=app.apks \ --ks=release.jks \ --ks-pass=pass:${KEYSTORE_PASSWORD} firebase appdistribution:distribute app.apks \ --app 1:123456789:android:abcd1234 \ --groups "qa-team"
6.2 异常监控体系
-
客户端异常采集：
kotlin复制class CrashHandler private constructor( private val defaultHandler: Thread.UncaughtExceptionHandler? ) : Thread.UncaughtExceptionHandler { override fun uncaughtException(thread: Thread, ex: Throwable) { // 构造异常报告 val report = CrashReport( timestamp = System.currentTimeMillis(), threadName = thread.name, stackTrace = ex.stackTraceToString(), deviceInfo = collectDeviceInfo(), userInfo = currentUser ) // 持久化存储 crashDao.insert(report) // 尝试上传（失败会下次启动时重试） uploadCrashReport(report) // 交给系统默认处理 defaultHandler?.uncaughtException(thread, ex) } } -
服务端健康指标：
| 指标名称 | 采集方式 | 告警阈值 |
|---|---|---|
| API成功率 | Prometheus采集 | <99%持续5分钟 |
| 平均响应时间 | Spring Boot Actuator | >500ms |
| JVM内存使用率 | Micrometer | >80% |
| 数据库连接池 | HikariCP监控 | 活跃连接>最大80% |
这个项目从技术选型到具体实现都充分考虑了大学生群体的使用场景和校园网络环境特点。在实际测试中，我们特别关注了以下体验细节：
- 在弱网环境下仍能流畅浏览课程信息
- 课间10分钟能完成核心操作（如查看评价、下载资料）
- 针对校园网IPv6环境的适配优化
- 与学校统一身份认证系统的无缝集成
这些细节处理使得APP在试点院校获得了87%的周活跃率，验证了我们技术方案的有效性。