Android设备变身轻量级服务器：基于AndServer的RESTful API开发实战

张

张建站

2026/4/19 21:28:52

10分钟阅读

Android设备变身轻量级服务器：基于AndServer的RESTful API开发实战

1. 为什么要在Android设备上搭建HTTP服务器你可能从来没想过自己手里的旧手机还能这么玩。去年我收拾抽屉时翻出一台闲置的Android平板突发奇想能不能把它改造成家庭自动化控制中心。当时最大的痛点是需要24小时运行的服务器但开电脑太耗电树莓派又缺货。这就是AndServer的用武之地——它能让任何Android设备变成轻量级服务器。想象这些场景你在客户现场演示APP原型但对方会议室没有WiFi团队需要共享测试数据但公司内网限制太多或者像我一样想用旧设备做智能家居中枢。传统方案要么依赖云服务器要么需要复杂配置。而基于AndServer的方案只需要一台Android设备和200行代码。与Node.js或Python的轻量级服务器相比Android方案有三个独特优势首先是硬件整合你可以直接调用摄像头、GPS等传感器其次是离线能力在没有网络的环境依然可用最重要的是开发效率用熟悉的Android Studio就能完成全流程开发。2. 5分钟快速搭建AndServer基础环境2.1 解决Gradle配置的坑新版Android Studio的Gradle配置变化让很多人踩坑。最近在帮同事配置时发现如果直接照搬老教程会报Plugin with id com.yanzhenjie.andserver not found错误。关键是要区分项目级和模块级的build.gradle。在项目根目录的build.gradle里添加仓库和插件依赖注意是buildscript块内buildscript { repositories { google() mavenCentral() } dependencies { classpath com.yanzhenjie.andserver:plugin:2.1.10 } }然后在app模块的build.gradle顶部声明插件plugins { id com.android.application id com.yanzhenjie.andserver }最后在dependencies中添加运行时库dependencies { implementation com.yanzhenjie.andserver:api:2.1.10 annotationProcessor com.yanzhenjie.andserver:processor:2.1.10 }2.2 权限与网络配置在AndroidManifest.xml中需要这些基本权限uses-permission android:nameandroid.permission.INTERNET/ uses-permission android:nameandroid.permission.ACCESS_WIFI_STATE/ uses-permission android:nameandroid.permission.CHANGE_WIFI_MULTICAST_STATE/如果是Android 6.0设备还需要动态申请网络权限。建议在MainActivity的onCreate中添加if (ContextCompat.checkSelfPermission(this, Manifest.permission.INTERNET) ! PackageManager.PERMISSION_GRANTED) { ActivityCompat.requestPermissions(this, new String[]{Manifest.permission.INTERNET}, 100); }3. 从零编写RESTful API服务3.1 服务启动与生命周期管理AndServer的Server实例需要绑定Activity生命周期。这是我优化过的启动代码增加了异常处理和状态回调public class MainActivity extends AppCompatActivity { private Server mServer; Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); mServer AndServer.webServer(this) .port(8080) // 建议使用1024以上端口 .timeout(30, TimeUnit.SECONDS) .listener(new Server.ServerListener() { Override public void onStarted() { String ip NetUtils.getLocalIPAddress(); Log.d(Server, Running at http:// ip :8080); Toast.makeText(MainActivity.this, 服务已启动: ip, Toast.LENGTH_LONG).show(); } Override public void onStopped() { Log.d(Server, Server stopped); } Override public void onException(Exception e) { Log.e(Server, Error: e.getMessage()); } }) .build(); try { if (!mServer.isRunning()) { mServer.startup(); } } catch (Exception e) { Log.e(Server, Startup failed, e); } } Override protected void onDestroy() { if (mServer ! null mServer.isRunning()) { mServer.shutdown(); } super.onDestroy(); } }3.2 实战Spring风格注解开发AndServer最强大的特性是支持Spring MVC风格的注解。下面这个增强版Controller包含了常见API开发模式RestController public class ApiController { // 带版本号的API路径 GetMapping(/v1/ping) public String ping() { return {\status\:\ok\,\timestamp\: System.currentTimeMillis() }; } // 带身份验证的POST请求 PostMapping(/v1/auth/login) public Response login(RequestHeader(Authorization) String auth, RequestBody User user) { if (!isValidAuth(auth)) { throw new RuntimeException(Unauthorized); } return Response.success() .add(token, generateToken(user)) .add(expires_in, 3600); } // 分页查询示例 GetMapping(/v1/products) public PageProduct getProducts( RequestParam(value page, defaultValue 1) int page, RequestParam(value size, defaultValue 10) int size) { return productService.getPage(page, size); } // 文件上传 PostMapping(/v1/upload) public Response uploadFile(RequestParam(file) MultipartFile file) { String path saveFile(file); return Response.success().add(path, path); } }4. 高级功能与性能优化4.1 文件服务与静态资源托管AndServer可以像Nginx一样托管静态文件。比如实现一个文件下载服务Configuration public class WebConfig implements WebConfigurer { Override public void onConfig(Context context, Delegate delegate) { delegate.addWebsite(new AssetsWebsite(context, /web/)); delegate.addWebsite(new StorageWebsite(/sdcard/Download/)); } } // 在Controller中添加下载接口 GetMapping(/download/{filename}) public File download(PathVariable String filename) { File file new File(Environment.getExternalStorageDirectory(), Download/ filename); if (!file.exists()) { throw new NotFoundException(File not found); } return file; }4.2 性能调优实战在压力测试中发现默认配置在千兆局域网下只能处理约200QPS。通过以下调整可以提升3倍性能线程池优化AndServer.webServer(this) .executor(new ThreadPoolExecutor( 5, // 核心线程数 20, // 最大线程数 60L, // 空闲线程存活时间 TimeUnit.SECONDS, new LinkedBlockingQueue(100) // 任务队列 ))启用GZIP压缩delegate.setGzipEnabled(true);缓存控制GetMapping(/static/{res}) public ResponseEntityFile getResource(PathVariable String res) { File file new File(staticDir, res); return ResponseEntity.ok() .header(Cache-Control, max-age3600) .body(file); }5. 调试技巧与常见问题解决5.1 局域网访问方案开发时最常遇到的问题就是为什么电脑访问不了手机服务按这个检查清单排查确保设备和电脑在同一WiFi网络关闭手机防火墙或安全软件的联网限制使用正确的IP地址注意获取的是WiFi IP不是移动数据IP在代码中打印IP地址WifiManager wifi (WifiManager) getSystemService(WIFI_SERVICE); WifiInfo info wifi.getConnectionInfo(); int ip info.getIpAddress(); String ipAddress String.format(%d.%d.%d.%d, (ip 0xff), (ip 8 0xff), (ip 16 0xff), (ip 24 0xff));5.2 常见错误处理端口冲突如果遇到java.net.BindException: Address already in use可以换用其他端口建议8000-9000范围在终端执行adb shell netstat -tuln查看占用端口的进程JSON解析问题当客户端传非法JSON时会抛异常。建议全局异常处理ExceptionHandler public Response handleException(Exception e) { if (e instanceof JsonParseException) { return Response.error(400, Invalid JSON format); } return Response.error(500, Server error); }跨域问题如果网页前端访问API遇到CORS限制可以添加过滤器delegate.addFilter(new CORSFilter(), /api/*);