尧图网页设计 
简介这份资源是一套基于Android的物流管理系统完整项目源码服务端采用Java技术栈实现适合计算机专业学生、Java Web初学者及需要课程设计或毕业设计参考的开发者。项目以JSP、Servlet结合Android客户端与Ajax异步交互构建数据库选用开源MySQL整体按表现层、业务层、数据访问层分层设计表现层遵循MVC结构业务层为每个模块提供独立接口与实现类代码结构清晰且便于适配不同数据库。压缩包共899个文件约9.48MB包含47个Java源文件与47个class编译文件、32个JSP页面、116个JavaScript脚本、24个CSS样式以及大量gif、png、jpg图片资源和18个jar依赖包另有properties、xml等配置文件覆盖前后端与资源素材。目前已有506人学习下载。通过研读这套源码读者可以掌握Android与服务端的数据交互流程、Servlet请求处理、DAO数据访问封装以及MVC分层组织方式是理解物流业务系统从界面到数据库完整链路的实用参考。1. 从一份 rar 说起Android 端 Java 服务端的物流管理系统到底怎么落地很多人拿到「基于 Android 的物流管理系统服务端 Java 实现.rar」这类压缩包第一反应是解压、找 README、跑 main 方法然后卡在数据库连不上、接口 404、Android 端 IP 写死这三件事上。它本质是一套典型的 C/S 架构练手项目Android 客户端负责运单录入、扫码、状态查询Java 服务端负责业务逻辑、数据持久化和接口暴露。适合谁想从「只会写单机 demo」跨到「能跑通客户端和服务端联调」的 Java 工程师、Android 初学者以及准备用物流场景做课程设计或面试项目的人。这一章先把这套系统的骨架讲清楚后面几章再拆服务端接口、Android 端对接、数据库设计和避坑。2. 服务端 Java 实现从建表到接口跑通的最小闭环服务端是这套系统的地基。物流业务的核心实体就那么几个用户、运单、物流轨迹、网点。选型上常见做法是 Spring Boot MyBatis MySQL原因很直接——依赖少、启动快、SQL 可控适合这种中小规模系统。如果你用的是纯 Servlet JDBC 的老写法逻辑一样成立只是配置更啰嗦。这一章按「建表 → 实体 → Mapper → Service → Controller」的顺序走一遍每一步都给可抄的代码。2.1 物流核心表结构怎么设计先建库建表。物流系统最怕的是运单状态和轨迹对不上所以表设计阶段就要把状态字段和轨迹表分开轨迹表只追加不修改。CREATE DATABASE logistics DEFAULT CHARACTER SET utf8mb4; USE logistics; -- 用户表区分管理员、网点操作员、普通客户 CREATE TABLE t_user ( id BIGINT PRIMARY KEY AUTO_INCREMENT, username VARCHAR(50) NOT NULL UNIQUE, password VARCHAR(100) NOT NULL, -- 存 MD5 或 BCrypt别存明文 role TINYINT NOT NULL DEFAULT 2, -- 0管理员 1操作员 2客户 phone VARCHAR(20), create_time DATETIME DEFAULT CURRENT_TIMESTAMP ); -- 运单表一条运单一个当前状态 CREATE TABLE t_order ( id BIGINT PRIMARY KEY AUTO_INCREMENT, order_no VARCHAR(32) NOT NULL UNIQUE, -- 业务单号对外暴露 sender_name VARCHAR(50), sender_phone VARCHAR(20), receiver_name VARCHAR(50), receiver_phone VARCHAR(20), address VARCHAR(255), status TINYINT NOT NULL DEFAULT 0, -- 0待揽收 1运输中 2派送中 3已签收 create_time DATETIME DEFAULT CURRENT_TIMESTAMP, update_time DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP ); -- 轨迹表只追加记录每次状态变更 CREATE TABLE t_track ( id BIGINT PRIMARY KEY AUTO_INCREMENT, order_no VARCHAR(32) NOT NULL, status TINYINT NOT NULL, remark VARCHAR(255), op_time DATETIME DEFAULT CURRENT_TIMESTAMP, INDEX idx_order_no (order_no) );order_no单独做业务单号而不是直接用自增 id是为了对外查询时不暴露数据量。t_track上的idx_order_no索引必须有否则轨迹查询在数据量上来后会全表扫描。status用 TINYINT 而不是字符串省空间也方便前端做状态映射。2.2 Spring Boot 里把运单接口写出来实体和 Mapper 用 MyBatis 生成或用注解手写都行这里直接给 Controller 和 Service 的关键部分重点看参数校验和状态流转。RestController RequestMapping(/api/order) public class OrderController { Autowired private OrderService orderService; // 创建运单客户端提交收发件人信息 PostMapping(/create) public Result create(RequestBody OrderDTO dto) { if (dto.getReceiverPhone() null || dto.getAddress() null) { return Result.fail(收件人电话和地址不能为空); } String orderNo orderService.createOrder(dto); return Result.ok(orderNo); } // 按单号查轨迹Android 端查询页调这个 GetMapping(/track/{orderNo}) public Result track(PathVariable String orderNo) { ListTrackVO list orderService.queryTrack(orderNo); return Result.ok(list); } // 更新状态操作员扫码后调用 PostMapping(/status) public Result updateStatus(RequestParam String orderNo, RequestParam Integer status, RequestParam(required false) String remark) { orderService.updateStatus(orderNo, status, remark); return Result.ok(); } }create接口里做了最基础的非空校验真实项目建议用Valid JSR303 注解但练手项目手写 if 更直观。track用PathVariable而不是RequestParam是为了让 URL 语义更清晰Android 端拼接也简单。updateStatus里状态和轨迹要在一个事务里写Service 层加Transactional否则会出现运单状态改了但轨迹没记录的脏数据。Service public class OrderServiceImpl implements OrderService { Autowired private OrderMapper orderMapper; Autowired private TrackMapper trackMapper; Override Transactional(rollbackFor Exception.class) public void updateStatus(String orderNo, Integer status, String remark) { Order order orderMapper.selectByOrderNo(orderNo); if (order null) { throw new RuntimeException(运单不存在); } // 状态只能往前走防止误操作回退 if (status order.getStatus()) { throw new RuntimeException(状态不能回退); } orderMapper.updateStatus(orderNo, status); Track track new Track(); track.setOrderNo(orderNo); track.setStatus(status); track.setRemark(remark); trackMapper.insert(track); } }Transactional(rollbackFor Exception.class)里的rollbackFor不能省默认只回滚 RuntimeException受检异常不会回滚。状态回退校验是物流系统的血泪经验没有这个判断操作员点错一次就得手动改库。2.3 接口测试先用 curl 跑通再连 Android服务端写完别急着开 Android Studio先用 curl 或 Postman 把接口跑通能省掉一半联调时间。# 启动服务默认 8080 mvn spring-boot:run # 创建运单 curl -X POST http://localhost:8080/api/order/create \ -H Content-Type: application/json \ -d {senderName:张三,receiverName:李四,receiverPhone:13800000000,address:北京市朝阳区} # 查轨迹 curl http://localhost:8080/api/order/track/SF1234567890 # 更新状态 curl -X POST http://localhost:8080/api/order/status?orderNoSF1234567890status1remark已揽收如果返回 404先看 Controller 的RequestMapping路径和端口如果返回 500 且日志里有Unknown database检查application.yml里的数据库名和账号密码。服务端接口测试这一步做扎实Android 端就只是「发请求、解析 JSON」的体力活。3. Android 客户端对接网络请求、列表和扫码怎么串起来Android 端是这套系统的门面也是最容易翻车的地方。常见做法是 Retrofit OkHttp Gson 做网络层RecyclerView 做运单列表扫码用 ZXing 或华为 ScanKit。这一章按「网络层 → 列表页 → 扫码页」的顺序讲重点说清楚 baseUrl 怎么配、异步回调怎么处理、权限怎么申请。3.1 Retrofit 网络层与 baseUrl 的坑Android 模拟器和真机访问本机服务端的地址不一样这是新手第一个大坑。模拟器用10.0.2.2映射宿主机localhost真机必须用电脑的局域网 IP。public class ApiClient { // 模拟器用 10.0.2.2真机改成电脑局域网 IP如 192.168.1.100 private static final String BASE_URL http://10.0.2.2:8080/; private static Retrofit retrofit; public static Retrofit getInstance() { if (retrofit null) { OkHttpClient client new OkHttpClient.Builder() .connectTimeout(10, TimeUnit.SECONDS) .readTimeout(10, TimeUnit.SECONDS) .build(); retrofit new Retrofit.Builder() .baseUrl(BASE_URL) .client(client) .addConverterFactory(GsonConverterFactory.create()) .build(); } return retrofit; } }BASE_URL必须以/结尾否则 Retrofit 拼接路径时会丢掉最后一段这是官方文档里都容易忽略的细节。超时时间设 10 秒物流查询接口一般不会超过这个数设太长会让用户以为卡死。Android 9 以后默认禁止明文 HTTP需要在AndroidManifest.xml的application标签加android:usesCleartextTraffictrue否则请求直接失败日志里只有一句Cleartext HTTP traffic not permitted。public interface OrderApi { POST(api/order/create) CallResultString createOrder(Body OrderDTO dto); GET(api/order/track/{orderNo}) CallResultListTrackVO queryTrack(PathVariable(orderNo) String orderNo); }接口定义和 Java 服务端的路径一一对应Path的变量名要和 URL 里的占位符一致。返回类型用ResultT包一层和服务端的统一返回结构对齐解析时不会因为字段缺失崩掉。3.2 运单列表页RecyclerView 与异步回调列表页是 Android 端最核心的页面用 RecyclerView Adapter 的标准写法重点看数据回来之后怎么刷新。public class OrderListActivity extends AppCompatActivity { private OrderAdapter adapter; private ListOrderVO dataList new ArrayList(); Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_order_list); RecyclerView rv findViewById(R.id.rv_order); rv.setLayoutManager(new LinearLayoutManager(this)); adapter new OrderAdapter(dataList); rv.setAdapter(adapter); loadOrders(); } private void loadOrders() { OrderApi api ApiClient.getInstance().create(OrderApi.class); api.queryTrack(SF1234567890).enqueue(new CallbackResultListTrackVO() { Override public void onResponse(CallResultListTrackVO call, ResponseResultListTrackVO resp) { if (resp.isSuccessful() resp.body() ! null resp.body().isOk()) { // 主线程更新 UI adapter.updateData(convert(resp.body().getData())); } } Override public void onFailure(CallResultListTrackVO call, Throwable t) { Toast.makeText(OrderListActivity.this, 网络异常 t.getMessage(), Toast.LENGTH_SHORT).show(); } }); } }enqueue是异步请求回调默认在主线程可以直接更新 UI别在里面再开子线程。onFailure里把t.getMessage()打出来常见的是Failed to connect to /10.0.2.2:8080说明服务端没启动或地址不对。Adapter 的updateData里要调notifyDataSetChanged()否则数据变了界面不动这是 RecyclerView 最经典的「玄学」问题。3.3 扫码录入与运行时权限物流场景离不开扫码用 ZXing 的CaptureActivity或自己集成zxing-android-embedded都行。关键是 Android 6.0 以后相机权限要动态申请。private static final int REQ_CAMERA 100; private void openScan() { if (ContextCompat.checkSelfPermission(this, Manifest.permission.CAMERA) ! PackageManager.PERMISSION_GRANTED) { ActivityCompat.requestPermissions(this, new String[]{Manifest.permission.CAMERA}, REQ_CAMERA); } else { startActivityForResult(new Intent(this, CaptureActivity.class), REQ_CAMERA); } } Override public void onRequestPermissionsResult(int requestCode, String[] permissions, int[] grantResults) { super.onRequestPermissionsResult(requestCode, permissions, grantResults); if (requestCode REQ_CAMERA grantResults.length 0 grantResults[0] PackageManager.PERMISSION_GRANTED) { startActivityForResult(new Intent(this, CaptureActivity.class), REQ_CAMERA); } else { Toast.makeText(this, 需要相机权限才能扫码, Toast.LENGTH_SHORT).show(); } }权限申请要在使用时动态请求不要在onCreate里一次性全申请用户体验差还容易被拒。扫码结果在onActivityResult里拿data.getStringExtra(result)拿到单号后直接调服务端的track接口查详情。如果扫码没反应先确认权限是否真的授予再看CaptureActivity是否在AndroidManifest.xml里注册。4. 避坑与排查联调阶段最容易翻车的 5 个点这一章是纯踩坑记录每条按「现象 → 原因 → 解决」写都是这套系统联调时高频出现的问题。现象一Android 端请求一直转圈最后超时。原因通常是 baseUrl 用了localhost或127.0.0.1在 Android 设备上这两个地址指向设备自己不是你的电脑。解决模拟器改10.0.2.2真机改电脑局域网 IP并确保手机和电脑在同一网段。用ipconfigWindows或ifconfigMac/Linux查电脑 IP。现象二服务端返回 200但 Android 端解析出来全是 null。原因是 Gson 解析时字段名对不上比如服务端返回order_noJava 实体写的是orderNo。解决在实体字段上加SerializedName(order_no)或者服务端统一用驼峰命名返回。建议后者省得每个字段都加注解。现象三运单状态更新了但轨迹列表没变化。原因是updateStatus没加事务或者轨迹插入失败但状态更新成功了。解决Service 方法加Transactional(rollbackFor Exception.class)并检查t_track表的order_no字段长度是否够单号超长会被截断导致查不到。现象四Android 9 以上真机请求直接失败日志提示明文流量被禁。原因是 Android 9 默认只允许 HTTPS。解决在AndroidManifest.xml的application标签加android:usesCleartextTraffictrue仅限开发阶段上线要换 HTTPS。现象五扫码后返回的单号带换行或空格查不到运单。原因是部分二维码内容末尾有不可见字符。解决拿到扫码结果后先trim()再传给服务端。这个坑很隐蔽日志里单号看起来一模一样但就是查不到。5. 进阶技巧用统一返回结构和日志把联调效率提上去这套系统跑通之后真正拉开效率差距的是两件事统一返回结构和请求日志。先看统一返回结构服务端所有接口都返回同一个壳Android 端只写一次解析逻辑。public class ResultT { private int code; // 0 成功非 0 失败 private String msg; private T data; public static T ResultT ok(T data) { ResultT r new Result(); r.code 0; r.msg success; r.data data; return r; } public static T ResultT fail(String msg) { ResultT r new Result(); r.code 500; r.msg msg; return r; } public boolean isOk() { return code 0; } }Android 端拿到响应先判断isOk()再取data失败时直接弹msg不用每个接口单独写错误处理。这个壳看起来简单但能省掉大量重复代码。第二件事是给 OkHttp 加日志拦截器把请求 URL、参数、响应体全打出来。联调阶段 90% 的问题看日志就能定位比猜快得多。HttpLoggingInterceptor logging new HttpLoggingInterceptor(); logging.setLevel(HttpLoggingInterceptor.Level.BODY); // 开发阶段用 BODY上线改 NONE OkHttpClient client new OkHttpClient.Builder() .addInterceptor(logging) .build();Level.BODY会打印完整请求体和响应体方便核对字段但上线前必须改成NONE否则用户敏感信息会进日志。我一般会在BuildConfig.DEBUG为 true 时才加这个拦截器一行判断解决。最后说一个验证方法服务端接口改完后先跑一遍 curl再用 Android 端跑一遍两边结果一致才算联调通过。别只信 Android 端界面显示正常有时候是缓存数据在骗你。这套系统本身不复杂难的是把「服务端接口测试」和「客户端和服务端」这两端的边界理清楚。我自己的习惯是每加一个接口先在 Postman 里存一条用例Android 端出问题时先跑用例确认服务端没问题再去查客户端。这个习惯帮我省了无数个加班的晚上。希望帮到你。本文还有配套的精品资源点击获取 基于Android与Java服务端的物流管理系统实战：从建表到联调避坑
简介这份资源是一套基于Android的物流管理系统完整项目源码服务端采用Java技术栈实现适合计算机专业学生、Java Web初学者及需要课程设计或毕业设计参考的开发者。项目以JSP、Servlet结合Android客户端与Ajax异步交互构建数据库选用开源MySQL整体按表现层、业务层、数据访问层分层设计表现层遵循MVC结构业务层为每个模块提供独立接口与实现类代码结构清晰且便于适配不同数据库。压缩包共899个文件约9.48MB包含47个Java源文件与47个class编译文件、32个JSP页面、116个JavaScript脚本、24个CSS样式以及大量gif、png、jpg图片资源和18个jar依赖包另有properties、xml等配置文件覆盖前后端与资源素材。目前已有506人学习下载。通过研读这套源码读者可以掌握Android与服务端的数据交互流程、Servlet请求处理、DAO数据访问封装以及MVC分层组织方式是理解物流业务系统从界面到数据库完整链路的实用参考。1. 从一份 rar 说起Android 端 Java 服务端的物流管理系统到底怎么落地很多人拿到「基于 Android 的物流管理系统服务端 Java 实现.rar」这类压缩包第一反应是解压、找 README、跑 main 方法然后卡在数据库连不上、接口 404、Android 端 IP 写死这三件事上。它本质是一套典型的 C/S 架构练手项目Android 客户端负责运单录入、扫码、状态查询Java 服务端负责业务逻辑、数据持久化和接口暴露。适合谁想从「只会写单机 demo」跨到「能跑通客户端和服务端联调」的 Java 工程师、Android 初学者以及准备用物流场景做课程设计或面试项目的人。这一章先把这套系统的骨架讲清楚后面几章再拆服务端接口、Android 端对接、数据库设计和避坑。2. 服务端 Java 实现从建表到接口跑通的最小闭环服务端是这套系统的地基。物流业务的核心实体就那么几个用户、运单、物流轨迹、网点。选型上常见做法是 Spring Boot MyBatis MySQL原因很直接——依赖少、启动快、SQL 可控适合这种中小规模系统。如果你用的是纯 Servlet JDBC 的老写法逻辑一样成立只是配置更啰嗦。这一章按「建表 → 实体 → Mapper → Service → Controller」的顺序走一遍每一步都给可抄的代码。2.1 物流核心表结构怎么设计先建库建表。物流系统最怕的是运单状态和轨迹对不上所以表设计阶段就要把状态字段和轨迹表分开轨迹表只追加不修改。CREATE DATABASE logistics DEFAULT CHARACTER SET utf8mb4; USE logistics; -- 用户表区分管理员、网点操作员、普通客户 CREATE TABLE t_user ( id BIGINT PRIMARY KEY AUTO_INCREMENT, username VARCHAR(50) NOT NULL UNIQUE, password VARCHAR(100) NOT NULL, -- 存 MD5 或 BCrypt别存明文 role TINYINT NOT NULL DEFAULT 2, -- 0管理员 1操作员 2客户 phone VARCHAR(20), create_time DATETIME DEFAULT CURRENT_TIMESTAMP ); -- 运单表一条运单一个当前状态 CREATE TABLE t_order ( id BIGINT PRIMARY KEY AUTO_INCREMENT, order_no VARCHAR(32) NOT NULL UNIQUE, -- 业务单号对外暴露 sender_name VARCHAR(50), sender_phone VARCHAR(20), receiver_name VARCHAR(50), receiver_phone VARCHAR(20), address VARCHAR(255), status TINYINT NOT NULL DEFAULT 0, -- 0待揽收 1运输中 2派送中 3已签收 create_time DATETIME DEFAULT CURRENT_TIMESTAMP, update_time DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP ); -- 轨迹表只追加记录每次状态变更 CREATE TABLE t_track ( id BIGINT PRIMARY KEY AUTO_INCREMENT, order_no VARCHAR(32) NOT NULL, status TINYINT NOT NULL, remark VARCHAR(255), op_time DATETIME DEFAULT CURRENT_TIMESTAMP, INDEX idx_order_no (order_no) );order_no单独做业务单号而不是直接用自增 id是为了对外查询时不暴露数据量。t_track上的idx_order_no索引必须有否则轨迹查询在数据量上来后会全表扫描。status用 TINYINT 而不是字符串省空间也方便前端做状态映射。2.2 Spring Boot 里把运单接口写出来实体和 Mapper 用 MyBatis 生成或用注解手写都行这里直接给 Controller 和 Service 的关键部分重点看参数校验和状态流转。RestController RequestMapping(/api/order) public class OrderController { Autowired private OrderService orderService; // 创建运单客户端提交收发件人信息 PostMapping(/create) public Result create(RequestBody OrderDTO dto) { if (dto.getReceiverPhone() null || dto.getAddress() null) { return Result.fail(收件人电话和地址不能为空); } String orderNo orderService.createOrder(dto); return Result.ok(orderNo); } // 按单号查轨迹Android 端查询页调这个 GetMapping(/track/{orderNo}) public Result track(PathVariable String orderNo) { ListTrackVO list orderService.queryTrack(orderNo); return Result.ok(list); } // 更新状态操作员扫码后调用 PostMapping(/status) public Result updateStatus(RequestParam String orderNo, RequestParam Integer status, RequestParam(required false) String remark) { orderService.updateStatus(orderNo, status, remark); return Result.ok(); } }create接口里做了最基础的非空校验真实项目建议用Valid JSR303 注解但练手项目手写 if 更直观。track用PathVariable而不是RequestParam是为了让 URL 语义更清晰Android 端拼接也简单。updateStatus里状态和轨迹要在一个事务里写Service 层加Transactional否则会出现运单状态改了但轨迹没记录的脏数据。Service public class OrderServiceImpl implements OrderService { Autowired private OrderMapper orderMapper; Autowired private TrackMapper trackMapper; Override Transactional(rollbackFor Exception.class) public void updateStatus(String orderNo, Integer status, String remark) { Order order orderMapper.selectByOrderNo(orderNo); if (order null) { throw new RuntimeException(运单不存在); } // 状态只能往前走防止误操作回退 if (status order.getStatus()) { throw new RuntimeException(状态不能回退); } orderMapper.updateStatus(orderNo, status); Track track new Track(); track.setOrderNo(orderNo); track.setStatus(status); track.setRemark(remark); trackMapper.insert(track); } }Transactional(rollbackFor Exception.class)里的rollbackFor不能省默认只回滚 RuntimeException受检异常不会回滚。状态回退校验是物流系统的血泪经验没有这个判断操作员点错一次就得手动改库。2.3 接口测试先用 curl 跑通再连 Android服务端写完别急着开 Android Studio先用 curl 或 Postman 把接口跑通能省掉一半联调时间。# 启动服务默认 8080 mvn spring-boot:run # 创建运单 curl -X POST http://localhost:8080/api/order/create \ -H Content-Type: application/json \ -d {senderName:张三,receiverName:李四,receiverPhone:13800000000,address:北京市朝阳区} # 查轨迹 curl http://localhost:8080/api/order/track/SF1234567890 # 更新状态 curl -X POST http://localhost:8080/api/order/status?orderNoSF1234567890status1remark已揽收如果返回 404先看 Controller 的RequestMapping路径和端口如果返回 500 且日志里有Unknown database检查application.yml里的数据库名和账号密码。服务端接口测试这一步做扎实Android 端就只是「发请求、解析 JSON」的体力活。3. Android 客户端对接网络请求、列表和扫码怎么串起来Android 端是这套系统的门面也是最容易翻车的地方。常见做法是 Retrofit OkHttp Gson 做网络层RecyclerView 做运单列表扫码用 ZXing 或华为 ScanKit。这一章按「网络层 → 列表页 → 扫码页」的顺序讲重点说清楚 baseUrl 怎么配、异步回调怎么处理、权限怎么申请。3.1 Retrofit 网络层与 baseUrl 的坑Android 模拟器和真机访问本机服务端的地址不一样这是新手第一个大坑。模拟器用10.0.2.2映射宿主机localhost真机必须用电脑的局域网 IP。public class ApiClient { // 模拟器用 10.0.2.2真机改成电脑局域网 IP如 192.168.1.100 private static final String BASE_URL http://10.0.2.2:8080/; private static Retrofit retrofit; public static Retrofit getInstance() { if (retrofit null) { OkHttpClient client new OkHttpClient.Builder() .connectTimeout(10, TimeUnit.SECONDS) .readTimeout(10, TimeUnit.SECONDS) .build(); retrofit new Retrofit.Builder() .baseUrl(BASE_URL) .client(client) .addConverterFactory(GsonConverterFactory.create()) .build(); } return retrofit; } }BASE_URL必须以/结尾否则 Retrofit 拼接路径时会丢掉最后一段这是官方文档里都容易忽略的细节。超时时间设 10 秒物流查询接口一般不会超过这个数设太长会让用户以为卡死。Android 9 以后默认禁止明文 HTTP需要在AndroidManifest.xml的application标签加android:usesCleartextTraffictrue否则请求直接失败日志里只有一句Cleartext HTTP traffic not permitted。public interface OrderApi { POST(api/order/create) CallResultString createOrder(Body OrderDTO dto); GET(api/order/track/{orderNo}) CallResultListTrackVO queryTrack(PathVariable(orderNo) String orderNo); }接口定义和 Java 服务端的路径一一对应Path的变量名要和 URL 里的占位符一致。返回类型用ResultT包一层和服务端的统一返回结构对齐解析时不会因为字段缺失崩掉。3.2 运单列表页RecyclerView 与异步回调列表页是 Android 端最核心的页面用 RecyclerView Adapter 的标准写法重点看数据回来之后怎么刷新。public class OrderListActivity extends AppCompatActivity { private OrderAdapter adapter; private ListOrderVO dataList new ArrayList(); Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_order_list); RecyclerView rv findViewById(R.id.rv_order); rv.setLayoutManager(new LinearLayoutManager(this)); adapter new OrderAdapter(dataList); rv.setAdapter(adapter); loadOrders(); } private void loadOrders() { OrderApi api ApiClient.getInstance().create(OrderApi.class); api.queryTrack(SF1234567890).enqueue(new CallbackResultListTrackVO() { Override public void onResponse(CallResultListTrackVO call, ResponseResultListTrackVO resp) { if (resp.isSuccessful() resp.body() ! null resp.body().isOk()) { // 主线程更新 UI adapter.updateData(convert(resp.body().getData())); } } Override public void onFailure(CallResultListTrackVO call, Throwable t) { Toast.makeText(OrderListActivity.this, 网络异常 t.getMessage(), Toast.LENGTH_SHORT).show(); } }); } }enqueue是异步请求回调默认在主线程可以直接更新 UI别在里面再开子线程。onFailure里把t.getMessage()打出来常见的是Failed to connect to /10.0.2.2:8080说明服务端没启动或地址不对。Adapter 的updateData里要调notifyDataSetChanged()否则数据变了界面不动这是 RecyclerView 最经典的「玄学」问题。3.3 扫码录入与运行时权限物流场景离不开扫码用 ZXing 的CaptureActivity或自己集成zxing-android-embedded都行。关键是 Android 6.0 以后相机权限要动态申请。private static final int REQ_CAMERA 100; private void openScan() { if (ContextCompat.checkSelfPermission(this, Manifest.permission.CAMERA) ! PackageManager.PERMISSION_GRANTED) { ActivityCompat.requestPermissions(this, new String[]{Manifest.permission.CAMERA}, REQ_CAMERA); } else { startActivityForResult(new Intent(this, CaptureActivity.class), REQ_CAMERA); } } Override public void onRequestPermissionsResult(int requestCode, String[] permissions, int[] grantResults) { super.onRequestPermissionsResult(requestCode, permissions, grantResults); if (requestCode REQ_CAMERA grantResults.length 0 grantResults[0] PackageManager.PERMISSION_GRANTED) { startActivityForResult(new Intent(this, CaptureActivity.class), REQ_CAMERA); } else { Toast.makeText(this, 需要相机权限才能扫码, Toast.LENGTH_SHORT).show(); } }权限申请要在使用时动态请求不要在onCreate里一次性全申请用户体验差还容易被拒。扫码结果在onActivityResult里拿data.getStringExtra(result)拿到单号后直接调服务端的track接口查详情。如果扫码没反应先确认权限是否真的授予再看CaptureActivity是否在AndroidManifest.xml里注册。4. 避坑与排查联调阶段最容易翻车的 5 个点这一章是纯踩坑记录每条按「现象 → 原因 → 解决」写都是这套系统联调时高频出现的问题。现象一Android 端请求一直转圈最后超时。原因通常是 baseUrl 用了localhost或127.0.0.1在 Android 设备上这两个地址指向设备自己不是你的电脑。解决模拟器改10.0.2.2真机改电脑局域网 IP并确保手机和电脑在同一网段。用ipconfigWindows或ifconfigMac/Linux查电脑 IP。现象二服务端返回 200但 Android 端解析出来全是 null。原因是 Gson 解析时字段名对不上比如服务端返回order_noJava 实体写的是orderNo。解决在实体字段上加SerializedName(order_no)或者服务端统一用驼峰命名返回。建议后者省得每个字段都加注解。现象三运单状态更新了但轨迹列表没变化。原因是updateStatus没加事务或者轨迹插入失败但状态更新成功了。解决Service 方法加Transactional(rollbackFor Exception.class)并检查t_track表的order_no字段长度是否够单号超长会被截断导致查不到。现象四Android 9 以上真机请求直接失败日志提示明文流量被禁。原因是 Android 9 默认只允许 HTTPS。解决在AndroidManifest.xml的application标签加android:usesCleartextTraffictrue仅限开发阶段上线要换 HTTPS。现象五扫码后返回的单号带换行或空格查不到运单。原因是部分二维码内容末尾有不可见字符。解决拿到扫码结果后先trim()再传给服务端。这个坑很隐蔽日志里单号看起来一模一样但就是查不到。5. 进阶技巧用统一返回结构和日志把联调效率提上去这套系统跑通之后真正拉开效率差距的是两件事统一返回结构和请求日志。先看统一返回结构服务端所有接口都返回同一个壳Android 端只写一次解析逻辑。public class ResultT { private int code; // 0 成功非 0 失败 private String msg; private T data; public static T ResultT ok(T data) { ResultT r new Result(); r.code 0; r.msg success; r.data data; return r; } public static T ResultT fail(String msg) { ResultT r new Result(); r.code 500; r.msg msg; return r; } public boolean isOk() { return code 0; } }Android 端拿到响应先判断isOk()再取data失败时直接弹msg不用每个接口单独写错误处理。这个壳看起来简单但能省掉大量重复代码。第二件事是给 OkHttp 加日志拦截器把请求 URL、参数、响应体全打出来。联调阶段 90% 的问题看日志就能定位比猜快得多。HttpLoggingInterceptor logging new HttpLoggingInterceptor(); logging.setLevel(HttpLoggingInterceptor.Level.BODY); // 开发阶段用 BODY上线改 NONE OkHttpClient client new OkHttpClient.Builder() .addInterceptor(logging) .build();Level.BODY会打印完整请求体和响应体方便核对字段但上线前必须改成NONE否则用户敏感信息会进日志。我一般会在BuildConfig.DEBUG为 true 时才加这个拦截器一行判断解决。最后说一个验证方法服务端接口改完后先跑一遍 curl再用 Android 端跑一遍两边结果一致才算联调通过。别只信 Android 端界面显示正常有时候是缓存数据在骗你。这套系统本身不复杂难的是把「服务端接口测试」和「客户端和服务端」这两端的边界理清楚。我自己的习惯是每加一个接口先在 Postman 里存一条用例Android 端出问题时先跑用例确认服务端没问题再去查客户端。这个习惯帮我省了无数个加班的晚上。希望帮到你。本文还有配套的精品资源点击获取