1. 项目背景与意义在高校校园中失物招领是高频且刚需的日常场景。传统方式主要依赖线下公告栏、QQ 群、朋友圈转发等方式存在信息分散、传播范围有限、查找效率低、认领流程不透明等问题。丢失物品的同学往往需要辗转多个渠道反复询问而拾到物品的同学也难以快速找到失主。基于 Android 的校园失物招领平台旨在通过移动互联网手段将失物发布、搜索、认领、留言互动等环节集中到一个应用中帮助师生快速发布和查找失物信息提升校园失物招领的整体效率。该平台具有以下现实意义信息集中化将分散在各渠道的失物信息统一汇聚方便快速检索。传播高效化借助移动端推送和分类筛选让信息精准触达目标人群。流程规范化通过认领申请与确认机制减少冒领和纠纷。数据可沉淀积累的失物数据可为校园后勤管理提供参考。2. 系统需求分析2.1 功能需求平台面向三类用户角色普通学生失主/拾主、管理员。核心功能模块如下模块功能说明用户模块注册、登录、个人信息维护、我的发布、我的认领失物发布发布丢失物品信息名称、类别、地点、时间、图片、描述拾物发布发布拾到物品信息支持图片上传搜索筛选按关键词、物品类别、丢失/拾取地点、时间范围检索认领流程失主提交认领申请拾主确认后完成认领留言互动对失物/拾物信息进行留言、评论管理后台用户管理、信息审核、删除违规内容、数据统计2.2 非功能需求易用性界面简洁发布流程不超过三步。安全性用户密码加密存储接口鉴权。性能列表页加载流畅图片采用压缩上传。可维护性前后端分离接口文档清晰。3. 系统总体设计3.1 系统架构系统采用前后端分离架构。Android 客户端通过 RESTful API 与后端服务通信后端负责业务逻辑与数据存储图片等静态资源可托管至对象存储服务。flowchart TD A[Android 客户端] --|HTTP/JSON| B[后端 API 服务] B -- C[(MySQL 数据库)] B -- D[图片存储服务] B -- E[Redis 缓存]3.2 技术栈选型层次技术选型说明客户端Kotlin / JavaAndroid 原生开发语言客户端框架Jetpack Compose 或 XML MVVMUI 构建与架构模式网络层Retrofit OkHttpHTTP 请求与响应处理图片加载Glide图片加载与缓存本地存储Room / DataStore本地缓存与偏好设置后端Spring Boot业务接口服务数据库MySQL关系型数据存储缓存Redis热点数据缓存接口文档Swagger / Knife4j接口调试与文档生成3.3 数据库设计核心数据表包括用户表、失物信息表、拾物信息表、认领记录表、留言表。以下为失物信息表的核心字段设计CREATE TABLE lost_item ( id BIGINT PRIMARY KEY AUTO_INCREMENT, user_id BIGINT NOT NULL COMMENT 发布用户ID, title VARCHAR(100) NOT NULL COMMENT 物品标题, category VARCHAR(50) COMMENT 物品类别, lost_location VARCHAR(200) COMMENT 丢失地点, lost_time DATETIME COMMENT 丢失时间, description TEXT COMMENT 详细描述, image_url VARCHAR(500) COMMENT 图片地址, status TINYINT DEFAULT 0 COMMENT 状态0待认领 1已认领, create_time DATETIME DEFAULT CURRENT_TIMESTAMP, update_time DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP );4. 核心功能实现4.1 Android 客户端实现客户端采用 MVVM 架构使用 Retrofit 封装网络请求。以下为失物信息列表的数据层实现// ApiService.kt interface ApiService { GET(api/lost/list) suspend fun getLostList( Query(page) page: Int, Query(size) size: Int, Query(keyword) keyword: String? ): ApiResponsePageResultLostItem POST(api/lost/add) suspend fun addLostItem(Body item: LostItemRequest): ApiResponseLong } // LostItemRepository.kt class LostItemRepository(private val apiService: ApiService) { suspend fun getLostList(page: Int, keyword: String?) apiService.getLostList(page, 10, keyword) suspend fun addLostItem(item: LostItemRequest) apiService.addLostItem(item) }ViewModel 层负责持有 UI 状态并调用仓库方法// LostListViewModel.kt class LostListViewModel(private val repository: LostItemRepository) : ViewModel() { private val _items MutableStateFlowListLostItem(emptyList()) val items: StateFlowListLostItem _items.asStateFlow() private val _loading MutableStateFlow(false) val loading: StateFlowBoolean _loading.asStateFlow() fun loadLostList(keyword: String? null) { viewModelScope.launch { _loading.value true try { val result repository.getLostList(1, keyword) _items.value result.data.records } catch (e: Exception) { // 异常处理 } finally { _loading.value false } } } }4.2 后端接口实现后端使用 Spring Boot 提供 RESTful 接口。以下为失物列表查询接口的 Controller 与 Service 实现// LostItemController.java RestController RequestMapping(/api/lost) public class LostItemController { Autowired private LostItemService lostItemService; GetMapping(/list) public ApiResponsePageResultLostItemVO list( RequestParam(defaultValue 1) int page, RequestParam(defaultValue 10) int size, RequestParam(required false) String keyword) { return ApiResponse.success(lostItemService.pageQuery(page, size, keyword)); } PostMapping(/add) public ApiResponseLong add(RequestBody LostItemRequest request) { return ApiResponse.success(lostItemService.addLostItem(request)); } }// LostItemServiceImpl.java Service public class LostItemServiceImpl implements LostItemService { Autowired private LostItemMapper lostItemMapper; Override public PageResultLostItemVO pageQuery(int page, int size, String keyword) { PageLostItem pageParam new Page(page, size); LambdaQueryWrapperLostItem wrapper new LambdaQueryWrapper(); if (StringUtils.hasText(keyword)) { wrapper.like(LostItem::getTitle, keyword) .or().like(LostItem::getDescription, keyword); } wrapper.orderByDesc(LostItem::getCreateTime); PageLostItem result lostItemMapper.selectPage(pageParam, wrapper); // 转换为 VO 并返回 return convertToPageResult(result); } Override public Long addLostItem(LostItemRequest request) { LostItem item new LostItem(); BeanUtils.copyProperties(request, item); item.setStatus(0); lostItemMapper.insert(item); return item.getId(); } }4.3 认领流程实现认领流程是平台的核心业务闭环。失主对拾物信息发起认领申请拾主确认后状态更新为已认领。以下为认领申请的后端实现// ClaimController.java RestController RequestMapping(/api/claim) public class ClaimController { Autowired private ClaimService claimService; PostMapping(/apply) public ApiResponseVoid apply(RequestBody ClaimRequest request) { claimService.applyClaim(request); return ApiResponse.success(null); } PostMapping(/confirm) public ApiResponseVoid confirm(RequestBody ClaimConfirmRequest request) { claimService.confirmClaim(request); return ApiResponse.success(null); } }// ClaimServiceImpl.java Service public class ClaimServiceImpl implements ClaimService { Autowired private ClaimMapper claimMapper; Autowired private LostItemMapper lostItemMapper; Override Transactional public void applyClaim(ClaimRequest request) { // 校验物品状态 LostItem item lostItemMapper.selectById(request.getItemId()); if (item null || item.getStatus() ! 0) { throw new BusinessException(该物品不可认领); } // 创建认领记录 ClaimRecord record new ClaimRecord(); record.setItemId(request.getItemId()); record.setClaimUserId(request.getClaimUserId()); record.setReason(request.getReason()); record.setStatus(0); // 待确认 claimMapper.insert(record); } Override Transactional public void confirmClaim(ClaimConfirmRequest request) { ClaimRecord record claimMapper.selectById(request.getClaimId()); if (record null) { throw new BusinessException(认领记录不存在); } record.setStatus(1); // 已确认 claimMapper.updateById(record); // 更新物品状态为已认领 LostItem item new LostItem(); item.setId(record.getItemId()); item.setStatus(1); lostItemMapper.updateById(item); } }5. 关键难点与解决方案5.1 图片上传与压缩移动端上传图片时原始照片体积较大直接上传会消耗大量流量并拖慢速度。解决方案是在客户端先进行压缩再上传至服务端。// ImageCompressor.kt fun compressImage(context: Context, uri: Uri, maxSize: Int 800): File { val options BitmapFactory.Options().apply { inJustDecodeBounds true } BitmapFactory.decodeStream(context.contentResolver.openInputStream(uri), null, options) var sampleSize 1 while (options.outWidth / sampleSize maxSize || options.outHeight / sampleSize maxSize) { sampleSize * 2 } val decodeOptions BitmapFactory.Options().apply { inSampleSize sampleSize } val bitmap BitmapFactory.decodeStream( context.contentResolver.openInputStream(uri), null, decodeOptions ) val file File(context.cacheDir, compressed_${System.currentTimeMillis()}.jpg) file.outputStream().use { fos - bitmap.compress(Bitmap.CompressFormat.JPEG, 80, fos) } return file }5.2 列表分页与下拉刷新失物信息会随着时间不断累积列表必须采用分页加载。客户端使用 Paging 3 或手动分页实现上拉加载更多配合下拉刷新保证数据实时性。// 手动分页加载示例 fun loadMore() { if (isLoading || isLastPage) return viewModelScope.launch { isLoading true currentPage try { val result repository.getLostList(currentPage, keyword) _items.value _items.value result.data.records isLastPage currentPage result.data.pages } catch (e: Exception) { currentPage-- } finally { isLoading false } } }6. 总结与展望本文围绕基于 Android 的校园失物招领平台从背景意义、需求分析、系统设计、技术选型到核心代码实现进行了完整阐述。平台通过移动端与后端服务的协同将失物发布、检索、认领流程线上化有效提升了校园失物招领的效率与体验。后续可从以下方向持续优化智能匹配基于物品类别、地点、时间等特征为失主与拾主推送可能匹配的信息。消息推送接入极光推送或 Firebase Cloud Messaging实现认领状态变更的实时通知。多端扩展在 Android 基础上扩展微信小程序或 Web 端覆盖更多使用场景。信用体系引入用户信用评分减少恶意发布与冒领行为。 
长河君 · 2026/9/7 9:08:20 · 阅读 1.2k 基于 Android 的校园失物招领平台：技术栈、背景意义与核心代码
1. 项目背景与意义在高校校园中失物招领是高频且刚需的日常场景。传统方式主要依赖线下公告栏、QQ 群、朋友圈转发等方式存在信息分散、传播范围有限、查找效率低、认领流程不透明等问题。丢失物品的同学往往需要辗转多个渠道反复询问而拾到物品的同学也难以快速找到失主。基于 Android 的校园失物招领平台旨在通过移动互联网手段将失物发布、搜索、认领、留言互动等环节集中到一个应用中帮助师生快速发布和查找失物信息提升校园失物招领的整体效率。该平台具有以下现实意义信息集中化将分散在各渠道的失物信息统一汇聚方便快速检索。传播高效化借助移动端推送和分类筛选让信息精准触达目标人群。流程规范化通过认领申请与确认机制减少冒领和纠纷。数据可沉淀积累的失物数据可为校园后勤管理提供参考。2. 系统需求分析2.1 功能需求平台面向三类用户角色普通学生失主/拾主、管理员。核心功能模块如下模块功能说明用户模块注册、登录、个人信息维护、我的发布、我的认领失物发布发布丢失物品信息名称、类别、地点、时间、图片、描述拾物发布发布拾到物品信息支持图片上传搜索筛选按关键词、物品类别、丢失/拾取地点、时间范围检索认领流程失主提交认领申请拾主确认后完成认领留言互动对失物/拾物信息进行留言、评论管理后台用户管理、信息审核、删除违规内容、数据统计2.2 非功能需求易用性界面简洁发布流程不超过三步。安全性用户密码加密存储接口鉴权。性能列表页加载流畅图片采用压缩上传。可维护性前后端分离接口文档清晰。3. 系统总体设计3.1 系统架构系统采用前后端分离架构。Android 客户端通过 RESTful API 与后端服务通信后端负责业务逻辑与数据存储图片等静态资源可托管至对象存储服务。flowchart TD A[Android 客户端] --|HTTP/JSON| B[后端 API 服务] B -- C[(MySQL 数据库)] B -- D[图片存储服务] B -- E[Redis 缓存]3.2 技术栈选型层次技术选型说明客户端Kotlin / JavaAndroid 原生开发语言客户端框架Jetpack Compose 或 XML MVVMUI 构建与架构模式网络层Retrofit OkHttpHTTP 请求与响应处理图片加载Glide图片加载与缓存本地存储Room / DataStore本地缓存与偏好设置后端Spring Boot业务接口服务数据库MySQL关系型数据存储缓存Redis热点数据缓存接口文档Swagger / Knife4j接口调试与文档生成3.3 数据库设计核心数据表包括用户表、失物信息表、拾物信息表、认领记录表、留言表。以下为失物信息表的核心字段设计CREATE TABLE lost_item ( id BIGINT PRIMARY KEY AUTO_INCREMENT, user_id BIGINT NOT NULL COMMENT 发布用户ID, title VARCHAR(100) NOT NULL COMMENT 物品标题, category VARCHAR(50) COMMENT 物品类别, lost_location VARCHAR(200) COMMENT 丢失地点, lost_time DATETIME COMMENT 丢失时间, description TEXT COMMENT 详细描述, image_url VARCHAR(500) COMMENT 图片地址, status TINYINT DEFAULT 0 COMMENT 状态0待认领 1已认领, create_time DATETIME DEFAULT CURRENT_TIMESTAMP, update_time DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP );4. 核心功能实现4.1 Android 客户端实现客户端采用 MVVM 架构使用 Retrofit 封装网络请求。以下为失物信息列表的数据层实现// ApiService.kt interface ApiService { GET(api/lost/list) suspend fun getLostList( Query(page) page: Int, Query(size) size: Int, Query(keyword) keyword: String? ): ApiResponsePageResultLostItem POST(api/lost/add) suspend fun addLostItem(Body item: LostItemRequest): ApiResponseLong } // LostItemRepository.kt class LostItemRepository(private val apiService: ApiService) { suspend fun getLostList(page: Int, keyword: String?) apiService.getLostList(page, 10, keyword) suspend fun addLostItem(item: LostItemRequest) apiService.addLostItem(item) }ViewModel 层负责持有 UI 状态并调用仓库方法// LostListViewModel.kt class LostListViewModel(private val repository: LostItemRepository) : ViewModel() { private val _items MutableStateFlowListLostItem(emptyList()) val items: StateFlowListLostItem _items.asStateFlow() private val _loading MutableStateFlow(false) val loading: StateFlowBoolean _loading.asStateFlow() fun loadLostList(keyword: String? null) { viewModelScope.launch { _loading.value true try { val result repository.getLostList(1, keyword) _items.value result.data.records } catch (e: Exception) { // 异常处理 } finally { _loading.value false } } } }4.2 后端接口实现后端使用 Spring Boot 提供 RESTful 接口。以下为失物列表查询接口的 Controller 与 Service 实现// LostItemController.java RestController RequestMapping(/api/lost) public class LostItemController { Autowired private LostItemService lostItemService; GetMapping(/list) public ApiResponsePageResultLostItemVO list( RequestParam(defaultValue 1) int page, RequestParam(defaultValue 10) int size, RequestParam(required false) String keyword) { return ApiResponse.success(lostItemService.pageQuery(page, size, keyword)); } PostMapping(/add) public ApiResponseLong add(RequestBody LostItemRequest request) { return ApiResponse.success(lostItemService.addLostItem(request)); } }// LostItemServiceImpl.java Service public class LostItemServiceImpl implements LostItemService { Autowired private LostItemMapper lostItemMapper; Override public PageResultLostItemVO pageQuery(int page, int size, String keyword) { PageLostItem pageParam new Page(page, size); LambdaQueryWrapperLostItem wrapper new LambdaQueryWrapper(); if (StringUtils.hasText(keyword)) { wrapper.like(LostItem::getTitle, keyword) .or().like(LostItem::getDescription, keyword); } wrapper.orderByDesc(LostItem::getCreateTime); PageLostItem result lostItemMapper.selectPage(pageParam, wrapper); // 转换为 VO 并返回 return convertToPageResult(result); } Override public Long addLostItem(LostItemRequest request) { LostItem item new LostItem(); BeanUtils.copyProperties(request, item); item.setStatus(0); lostItemMapper.insert(item); return item.getId(); } }4.3 认领流程实现认领流程是平台的核心业务闭环。失主对拾物信息发起认领申请拾主确认后状态更新为已认领。以下为认领申请的后端实现// ClaimController.java RestController RequestMapping(/api/claim) public class ClaimController { Autowired private ClaimService claimService; PostMapping(/apply) public ApiResponseVoid apply(RequestBody ClaimRequest request) { claimService.applyClaim(request); return ApiResponse.success(null); } PostMapping(/confirm) public ApiResponseVoid confirm(RequestBody ClaimConfirmRequest request) { claimService.confirmClaim(request); return ApiResponse.success(null); } }// ClaimServiceImpl.java Service public class ClaimServiceImpl implements ClaimService { Autowired private ClaimMapper claimMapper; Autowired private LostItemMapper lostItemMapper; Override Transactional public void applyClaim(ClaimRequest request) { // 校验物品状态 LostItem item lostItemMapper.selectById(request.getItemId()); if (item null || item.getStatus() ! 0) { throw new BusinessException(该物品不可认领); } // 创建认领记录 ClaimRecord record new ClaimRecord(); record.setItemId(request.getItemId()); record.setClaimUserId(request.getClaimUserId()); record.setReason(request.getReason()); record.setStatus(0); // 待确认 claimMapper.insert(record); } Override Transactional public void confirmClaim(ClaimConfirmRequest request) { ClaimRecord record claimMapper.selectById(request.getClaimId()); if (record null) { throw new BusinessException(认领记录不存在); } record.setStatus(1); // 已确认 claimMapper.updateById(record); // 更新物品状态为已认领 LostItem item new LostItem(); item.setId(record.getItemId()); item.setStatus(1); lostItemMapper.updateById(item); } }5. 关键难点与解决方案5.1 图片上传与压缩移动端上传图片时原始照片体积较大直接上传会消耗大量流量并拖慢速度。解决方案是在客户端先进行压缩再上传至服务端。// ImageCompressor.kt fun compressImage(context: Context, uri: Uri, maxSize: Int 800): File { val options BitmapFactory.Options().apply { inJustDecodeBounds true } BitmapFactory.decodeStream(context.contentResolver.openInputStream(uri), null, options) var sampleSize 1 while (options.outWidth / sampleSize maxSize || options.outHeight / sampleSize maxSize) { sampleSize * 2 } val decodeOptions BitmapFactory.Options().apply { inSampleSize sampleSize } val bitmap BitmapFactory.decodeStream( context.contentResolver.openInputStream(uri), null, decodeOptions ) val file File(context.cacheDir, compressed_${System.currentTimeMillis()}.jpg) file.outputStream().use { fos - bitmap.compress(Bitmap.CompressFormat.JPEG, 80, fos) } return file }5.2 列表分页与下拉刷新失物信息会随着时间不断累积列表必须采用分页加载。客户端使用 Paging 3 或手动分页实现上拉加载更多配合下拉刷新保证数据实时性。// 手动分页加载示例 fun loadMore() { if (isLoading || isLastPage) return viewModelScope.launch { isLoading true currentPage try { val result repository.getLostList(currentPage, keyword) _items.value _items.value result.data.records isLastPage currentPage result.data.pages } catch (e: Exception) { currentPage-- } finally { isLoading false } } }6. 总结与展望本文围绕基于 Android 的校园失物招领平台从背景意义、需求分析、系统设计、技术选型到核心代码实现进行了完整阐述。平台通过移动端与后端服务的协同将失物发布、检索、认领流程线上化有效提升了校园失物招领的效率与体验。后续可从以下方向持续优化智能匹配基于物品类别、地点、时间等特征为失主与拾主推送可能匹配的信息。消息推送接入极光推送或 Firebase Cloud Messaging实现认领状态变更的实时通知。多端扩展在 Android 基础上扩展微信小程序或 Web 端覆盖更多使用场景。信用体系引入用户信用评分减少恶意发布与冒领行为。