SpringBoot + 若依 APP版本更新功能实战踩坑记录

SpringBoot + 若依 APP版本更新功能实战踩坑记录

一、前言

本次开发需求：实现Android APP版本检测、整包/wgt热更新包下载功能。

技术栈：SpringBoot、RuoYi-Vue(para框架)、SpringSecurity、Nginx、MySQL。

本篇博客只针对开发中 静态资源原理、Security放行配置、端口访问原理 三大核心难点详细直白讲解，无多余废话。

二、业务需求说明

2.1 业务逻辑

1. APP请求后端检测是否有新版本；

2. 优先判断是否有更高版本整包(packageType=0)；

3. 若无整包，返回wgt热更新包(packageType=1)；

4. 后端返回下载URL，前端不允许处理文件流，必须返回纯浏览器下载地址。

三、SpringBoot静态资源目录方案详解（最终采用）

3.1 存放路径

将APK安装包存放至项目内部路径：

src/main/resources/static/app/profile/apk/xxx.apk

3.2 核心原理（最重要）

SpringBoot 内置约定：resources/static 为官方默认静态资源目录。

SpringBoot 内置Tomcat服务器，启动后会自动扫描、映射该目录，不需要配置、不需要Nginx、不需要写任何代码。

3.3 映射规则（死记硬背）

static后面的路径 = 浏览器访问路径

项目物理路径	浏览器访问URL
static/app/profile/apk/xxx.apk	http://ip:port/app/profile/apk/xxx.apk

3.4 为什么选用该方案？

• 无需编写文件流下载接口，代码零侵入；

• 无需修改Nginx配置，不用操作服务器；

• 返回纯URL，前端不用处理流、不用解析二进制；

• 打包时APK打进Jar包，部署简单，线上本地一致。

四、401认证失败 & SecurityConfig配置详解

4.1 问题现象

静态APK地址访问提示：认证失败，无法访问系统资源 401。

4.2 产生原因

若依框架（Para）内置 SpringSecurity安全拦截机制，默认：

• 除登录、验证码等白名单接口；

• 所有请求必须携带Token令牌；

• 静态资源默认放行不全，apk不在放行名单中，被拦截。

4.3 解决方案代码

.antMatchers(HttpMethod.GET, "/", "/*.html", "/**/*.html", "/**/*.css", "/**/*.js", "/profile/**", "/app/profile/apk/**").permitAll()

4.4 代码逐行详细解释

1. HttpMethod.GET：只放行GET请求；

2. /app/profile/apk/**：匹配该路径下所有文件（包含所有APK）；

3. permitAll()：匿名访问，不需要Token、不需要登录。

五、两种放行方式详细区别（新手必懂）

5.1 两种放行写法

// 写法1：指定请求方式放行
.antMatchers(HttpMethod.GET, "/app/profile/apk/**").permitAll()
// 写法2：不指定请求方式放行
.antMatchers("/shanguoTrace/**").permitAll()

5.2 核心区别

放行方式	支持请求类型	适用场景	安全性
HttpMethod.GET	仅放行GET	静态资源（apk、图片、html、js、css）	高（推荐）
不指定请求方式	GET/POST/PUT/DELETE全部放行	页面、业务匿名接口	低

5.3 开发规范

静态资源一律使用 GET 方式放行，禁止全部请求放行，防止恶意提交请求，保证安全。

六、本地不加端口号无法访问详解

6.1 现象

• 本地访问：http://192\.168\.1\.143/app/profile/apk/xxx\.apk（失败）

• 本地访问：http://192\.168\.1\.143:8080/app/profile/apk/xxx\.apk（成功）

6.2 根本原理

1. 你的SpringBoot项目运行端口：8080；

2. 浏览器默认端口：80；

3. 本地开发没有Nginx反向代理；

4. 端口不一致，浏览器找不到服务，直接访问失败。

6.3 线上为什么不用加端口？

线上服务器配置了 Nginx反向代理：

用户访问（80端口）→ Nginx转发 → 后端8080端口

所以线上下载地址不需要端口。

6.4 通俗口诀

本地无Nginx，必须加端口；线上有Nginx，不用加端口。

七、最终总结

1. 静态资源：static目录自动映射，最简单零配置；

2. Security放行：apk必须手动放行，否则401拦截；

3. 放行规范：静态资源只用GET放行，保证安全；

4. 端口原理：本地带端口、线上不带端口。

本次功能完全满足前端要求：不处理文件流、纯URL下载、匿名访问、不改Nginx，非常适合企业内部APP版本更新。