搜索到
18
篇与
的结果
-
EasyExcel 实战：导出带图片的 Excel 完整方案 在实际开发中，可能会遇到导出 Excel 时需要包含图片的场景。EasyExcel 作为阿里开源的高效 Excel 处理工具，虽然原生支持图片导出，但在图片格式适配、单元格样式调整等细节上需要自定义扩展。本文将详细讲解如何基于 EasyExcel 实现带图片的 Excel 导出，包含完整代码示例和关键细节说明。一、最终效果展示导出的 Excel 中，图片将自适应单元格大小，无图片时显示"无图"提示，整体格式整洁规范：二、实现步骤详解1. 引入依赖首先在 pom.xml 中添加 EasyExcel 核心依赖（本文使用 4.0.3 版本，适配大部分场景）：<dependency> <groupId>com.alibaba</groupId> <artifactId>easyexcel</artifactId> <version>4.0.3</version> </dependency>2. 定义导出实体类创建 RecordExcelVO 作为 Excel 导出的数据载体，核心关注图片字段的配置：package com.retail.ocr.model.vo; import com.alibaba.excel.annotation.ExcelProperty; import com.alibaba.excel.annotation.write.style.ColumnWidth; import com.retail.ocr.excel.converter.ImageConverter; import lombok.Data; /** * Excel 导出实体（识别记录） * * @author jucunqi * @since 2025/11/20 */ @Data public class RecordExcelVO { @ColumnWidth(20) // 列宽设置 @ExcelProperty("手机号") // Excel 表头名称 private String phoneNumber; @ColumnWidth(25) @ExcelProperty("识别时间") private String createTime; @ColumnWidth(20) @ExcelProperty("识别读数") private String number1; @ColumnWidth(20) @ExcelProperty("识别条码") private String number2; // 图片字段：使用自定义转换器处理 byte[] 类型 @ExcelProperty(value = "识别照片", converter = ImageConverter.class) private byte[] imageBytes; @ColumnWidth(20) @ExcelProperty("标记内容") private String markDesc; @ColumnWidth(20) @ExcelProperty("备注") private String remark; }关键说明：图片字段类型为 byte[]：便于存储图片二进制数据（可从文件、数据库 BLOB 字段、网络图片转换获取）。@ExcelProperty(converter = ImageConverter.class)：指定自定义转换器，将 byte[] 转换为 Excel 可识别的图片格式。@ColumnWidth：统一设置列宽，优化 Excel 显示效果。3. 实现图片转换器（核心）自定义 ImageConverter 实现 Converter<byte[]> 接口，负责将图片二进制数据转换为 EasyExcel 支持的 ImageData 格式：package com.retail.ocr.excel.converter; import com.alibaba.excel.converters.Converter; import com.alibaba.excel.enums.CellDataTypeEnum; import com.alibaba.excel.metadata.GlobalConfiguration; import com.alibaba.excel.metadata.data.ImageData; import com.alibaba.excel.metadata.data.ReadCellData; import com.alibaba.excel.metadata.data.WriteCellData; import com.alibaba.excel.metadata.property.ExcelContentProperty; import com.alibaba.excel.util.ListUtils; import lombok.extern.slf4j.Slf4j; import org.springframework.util.CollectionUtils; import java.util.List; @Slf4j public class ImageConverter implements Converter<byte[]> { @Override public Class<?> supportJavaTypeKey() { return List.class; } @Override public CellDataTypeEnum supportExcelTypeKey() { return CellDataTypeEnum.EMPTY; } @Override public byte[] convertToJavaData(ReadCellData<?> cellData, ExcelContentProperty contentProperty, GlobalConfiguration globalConfiguration) throws Exception { return null; } @Override public WriteCellData<?> convertToExcelData(byte[] value, ExcelContentProperty contentProperty, GlobalConfiguration globalConfiguration) throws Exception { // 这里进行对数据实体类的byte[]进行处理 List<ImageData> data = ListUtils.newArrayList(); ImageData imageData; try { imageData = new ImageData(); imageData.setImage(value); data.add(imageData); } catch (Exception e) { log.error("导出临时记录图片异常：", e); } WriteCellData<?> cellData = new WriteCellData<>(); if (!CollectionUtils.isEmpty(data)) { // 图片返回图片列表 cellData.setImageDataList(data); cellData.setType(CellDataTypeEnum.EMPTY); } else { // 没有图片使用汉字表示 cellData.setStringValue("无图"); cellData.setType(CellDataTypeEnum.STRING); } return cellData; } }核心逻辑：校验图片二进制数据有效性，避免空指针异常。有图片时：封装 ImageData 列表，指定 Excel 单元格类型为 IMAGE。无图片时：设置文本"无图"，单元格类型为 STRING，提升用户体验。4. 自定义图片写入处理器由于 EasyExcel 原生图片导出不支持自适应单元格、多图片排列等需求，需自定义 CellWriteHandler 处理图片的位置、大小和样式：package com.retail.ocr.excel.handler; import com.alibaba.excel.enums.CellDataTypeEnum; import com.alibaba.excel.metadata.Head; import com.alibaba.excel.metadata.data.ImageData; import com.alibaba.excel.metadata.data.WriteCellData; import com.alibaba.excel.write.handler.CellWriteHandler; import com.alibaba.excel.write.metadata.holder.WriteSheetHolder; import com.alibaba.excel.write.metadata.holder.WriteTableHolder; import org.apache.commons.collections4.CollectionUtils; import org.apache.poi.hssf.usermodel.HSSFWorkbook; import org.apache.poi.ss.usermodel.*; import org.apache.poi.util.Units; import org.apache.poi.xssf.usermodel.XSSFDrawing; import org.apache.poi.xssf.usermodel.XSSFPicture; import org.apache.poi.xssf.usermodel.XSSFShape; import java.util.List; import java.util.concurrent.CopyOnWriteArrayList; import java.util.concurrent.atomic.AtomicReference; public class ImageWriteHandler implements CellWriteHandler { /** * 已经处理的Cell */ private final CopyOnWriteArrayList<String> REPEATS = new CopyOnWriteArrayList<>(); /** * 单元格的图片最大张数（每列的单元格图片张数不确定，单元格宽度需按照张数最多的长度来设置） */ private final AtomicReference<Integer> MAX_IMAGE_SIZE = new AtomicReference<>(0); /** * 标记手动添加的图片，用于排除EasyExcel自动添加的图片 */ private final CopyOnWriteArrayList<Integer> CREATE_PIC_INDEX = new CopyOnWriteArrayList<>(); @Override public void beforeCellCreate(WriteSheetHolder writeSheetHolder, WriteTableHolder writeTableHolder, Row row, Head head, Integer columnIndex, Integer relativeRowIndex, Boolean isHead) { } @Override public void afterCellCreate(WriteSheetHolder writeSheetHolder, WriteTableHolder writeTableHolder, Cell cell, Head head, Integer relativeRowIndex, Boolean isHead) { } @Override public void afterCellDataConverted(WriteSheetHolder writeSheetHolder, WriteTableHolder writeTableHolder, WriteCellData<?> cellData, Cell cell, Head head, Integer relativeRowIndex, Boolean isHead) { // 在 数据转换成功后 不是头就把类型设置成空 if (isHead) { return; } // 将要插入图片的单元格的type设置为空,下面再填充图片 if (CollectionUtils.isNotEmpty(cellData.getImageDataList())) { cellData.setType(CellDataTypeEnum.EMPTY); } } @Override public void afterCellDispose(WriteSheetHolder writeSheetHolder, WriteTableHolder writeTableHolder, List<WriteCellData<?>> cellDataList, Cell cell, Head head, Integer relativeRowIndex, Boolean isHead) { // 在 单元格写入完毕后 ，自己填充图片 if (isHead || CollectionUtils.isEmpty(cellDataList)) { return; } boolean listFlag = false; Sheet sheet = cell.getSheet(); // 此处为ExcelUrlConverterUtil的返回值 List<ImageData> imageDataList = cellDataList.get(0).getImageDataList(); if (CollectionUtils.isNotEmpty(imageDataList)) { listFlag = true; } if (!listFlag && imageDataList == null) { return; } String key = cell.getRowIndex() + "_" + cell.getColumnIndex(); if (REPEATS.contains(key)) { return; } REPEATS.add(key); if (imageDataList.size() > MAX_IMAGE_SIZE.get()) { MAX_IMAGE_SIZE.set(imageDataList.size()); } // 默认要导出的图片大小为60*60px,60px的行高大约是900,60px列宽大概是248*8 sheet.getRow(cell.getRowIndex()).setHeight((short) 900); sheet.setColumnWidth(cell.getColumnIndex(), listFlag ? 240 * 8 * MAX_IMAGE_SIZE.get() : 240 * 8); if (listFlag) { for (int i = 0; i < imageDataList.size(); i++) { ImageData imageData = imageDataList.get(i); if (imageData == null) { continue; } byte[] image = imageData.getImage(); this.insertImage(sheet, cell, image, i); } } else { this.insertImage(sheet, cell, imageDataList.get(0).getImage(), 0); } // 清除EasyExcel自动添加的没有格式的图片 XSSFDrawing drawingPatriarch = (XSSFDrawing) sheet.getDrawingPatriarch(); List<XSSFShape> shapes = drawingPatriarch.getShapes(); for (int i = 0; i < shapes.size(); i++) { XSSFShape shape = shapes.get(i); if (shape instanceof XSSFPicture && !CREATE_PIC_INDEX.contains(i)) { CREATE_PIC_INDEX.add(i); XSSFPicture picture = (XSSFPicture) shape; picture.resize(0); } } } /** * 重新插入一个图片 * * @param sheet Excel页面 * @param cell 表格元素 * @param pictureData 图片数据 * @param i 图片顺序 */ private void insertImage(Sheet sheet, Cell cell, byte[] pictureData, int i) { int picWidth = Units.pixelToEMU(60); int index = sheet.getWorkbook().addPicture(pictureData, HSSFWorkbook.PICTURE_TYPE_PNG); CREATE_PIC_INDEX.add(index); Drawing<?> drawing = sheet.getDrawingPatriarch(); if (drawing == null) { drawing = sheet.createDrawingPatriarch(); } CreationHelper helper = sheet.getWorkbook().getCreationHelper(); ClientAnchor anchor = helper.createClientAnchor(); // 设置图片坐标 anchor.setDx1(picWidth * i); anchor.setDx2(picWidth + picWidth * i); anchor.setDy1(0); anchor.setDy2(0); // 设置图片位置 int columnIndex = cell.getColumnIndex(); anchor.setCol1(columnIndex); anchor.setCol2(columnIndex); int rowIndex = cell.getRowIndex(); anchor.setRow1(rowIndex); anchor.setRow2(rowIndex + 1); // ClientAnchor.AnchorType里有多种类型可选，从网上看的之前是不移动，直接悬浮在单元格上了，现在这个是随着单元格移动 anchor.setAnchorType(ClientAnchor.AnchorType.MOVE_AND_RESIZE); drawing.createPicture(anchor, index); } }核心功能：自适应行列宽：根据图片数量动态调整列宽，固定行高适配 60*60px 图片。多图片横向排列：支持单元格内多图片横向显示，间距 10px，避免重叠。图片随单元格移动：设置锚点类型为 MOVE_AND_RESIZE，图片会随单元格位置变化而同步移动。5. 业务层导出实现最后在 Controller 中编写导出接口，整合上述组件完成 Excel 导出：@GetMapping("/recognizeRecordExport") public void recognizeRecordExport(RecognizeRecordPageReqVo reqVo, HttpServletResponse response) throws IOException { // 获取数据逻辑省略 List<RecordExcelVO> excelVOList = getRecordExcelVOS(reqVo); String filename = "识别数据.xlsx"; // 输出 Excel EasyExcel.write(response.getOutputStream(), RecordExcelVO.class) .autoCloseStream(false) // 不要自动关闭，交给 Servlet 自己处理 .registerWriteHandler(new ImageWriteHandler()) .sheet(filename).doWrite(excelVOList); // 设置 header 和 contentType。写在最后的原因是，避免报错时，响应 contentType 已经被修改了 response.addHeader("Content-Disposition", "attachment;filename=" + URLEncoder.encode(filename)); response.setContentType("application/vnd.ms-excel;charset=UTF-8"); }关键注意事项：中文文件名乱码：使用 URLEncoder.encode 编码文件名，并指定 filename*=UTF-8'' 格式，兼容主流浏览器。响应头设置：contentType 对于 xlsx 格式需设置为 application/vnd.openxmlformats-officedocument.spreadsheetml.sheet，xls 格式需改为 application/vnd.ms-excel。流关闭策略：设置 autoCloseStream(false)，避免 EasyExcel 提前关闭响应流导致下载失败。以上就是使用EasyExcel导出带图片文件的所有内容了，希望对大家有所帮助～ -
Java 高效替换 Word 文档内容（模板填充方案） 使用java操作Excel大家应该非常熟悉，但是操作word可能会稍微少一点。本文将提供一套基于 Apache POI 的完整解决方案，支持普通段落+表格单元格的占位符替换，逻辑简洁、可直接复用。一、核心思路模板设计：在 Word 文档中，用 {{占位符名}} 标记需要替换的内容（如 {{name}}、{{date}}）；技术选型：使用 Apache POI（poi-ooxml）解析 .docx 文档，遍历段落和表格，替换占位符；核心优势：无需依赖第三方付费组件，支持复杂文档结构，兼容主流 Word 版本。二、实现步骤1. 环境准备（添加 Maven 依赖）核心依赖 poi-ooxml 用于处理 Office Open XML 格式（.docx），兼容 5.2.0 及以上版本（推荐使用最新稳定版）：<dependency> <groupId>org.apache.poi</groupId> <artifactId>poi-ooxml</artifactId> <version>5.2.0</version> <!-- 你可以使用最新版本 --> </dependency> <dependency> <groupId>org.apache.poi</groupId> <artifactId>poi</artifactId> <version>5.2.0</version> </dependency>2. 编写工具类（完整可运行代码）工具类封装了「读取模板、替换占位符、保存文件」全流程，支持普通段落和表格单元格的替换，还保留了原文本格式（字体、大小、颜色）：package com.water.ocrimagerecognize.util; import org.apache.poi.xwpf.usermodel.*; import java.io.*; import java.util.HashMap; import java.util.List; import java.util.Map; public class WordTemplateExporter { public static void main(String[] args) { // 输出文件路径 String outputPath = "output.docx"; try { Map<String,String> contractData = new HashMap<>(); // 占位符替换 contractData.put("date", "2025"); contractData.put("s15", "FF"); contractData.put("s16", "增效降本"); contractData.put("name", "张三"); contractData.put("luca", "lucaju"); contractData.put("s1", "game"); // 加载资源文件夹resources/tem文件夹下的合同模板 //不在resources获取模板文件需要修改此处，通过这个方法只能获取resources中的资源文件 InputStream templateInputStream = new FileInputStream("/Users/lucaju/Documents/文档/水务/word/template.docx"); XWPFDocument document = new XWPFDocument(templateInputStream); // 遍历文档中的段落 for (XWPFParagraph paragraph : document.getParagraphs()) { if (paragraph == null || paragraph.getRuns().size() == 0){ continue; } //替换占位符 change(paragraph,contractData); } // 遍历文档中的表格 for (XWPFTable table : document.getTables()) { for (XWPFTableRow row : table.getRows()) { for (XWPFTableCell cell : row.getTableCells()) { // 遍历单元格中的段落 for (XWPFParagraph cellParagraph : cell.getParagraphs()) { //替换占位符 change(cellParagraph,contractData); } } } } // 遍历文档中的图片 for (XWPFPictureData picture : document.getAllPictures()) { // 图片不会被修改，直接跳过 //需要修改图片在此处 System.out.println("图片： " + picture.getFileName()); } //该路径为相对路径，默认创建保存位置为项目文件所在盘符的根目录下 // 保存填充后的合同（将毫秒数添加到文件名防止命名冲突） String filePath = "contract_" + System.currentTimeMillis() + ".docx"; //检查目录是否存在，不存在则创建 File directory = new File(filePath); // 使用 FileOutputStream 保存填充后的合同 try (FileOutputStream out = new FileOutputStream(filePath)) { document.write(out); // 将内容写入文件 } System.out.println("输出完成"); } catch (Exception e) { e.printStackTrace(); } } //替换占位符方法 public static void change(XWPFParagraph paragraph, Map<String, String> contractData){ for (XWPFRun run : paragraph.getRuns()) { // 获取当前 run 的文本 String runText = run.getText(0); if (runText == null){ continue; } StringBuilder newText = new StringBuilder(runText); // 替换占位符 for (Map.Entry<String, String> entry : contractData.entrySet()) { //此处的占位符“{{”和“}}”可以任意更改，合同模板文件随着替换即可。 String placeholder = "{{" + entry.getKey() + "}}"; int startIndex = newText.indexOf(placeholder); while (startIndex != -1) { newText.replace(startIndex, startIndex + placeholder.length(), entry.getValue()); startIndex = newText.indexOf(placeholder, startIndex + entry.getValue().length()); } } // 更新替换后的文本 run.setText(newText.toString(), 0); } } /** * 替换 Word 文件中的占位符（支持普通段落 + 表格单元格） * * @param document Word 文档对象 * @param placeholder 占位符，例如 {{name}} * @param replacement 替换后的值，例如 "张三" */ private static void replacePlaceholder(XWPFDocument document, String placeholder, String replacement) { // 1. 替换普通段落中的占位符（原有逻辑保留） for (XWPFParagraph paragraph : document.getParagraphs()) { replaceRunInParagraph(paragraph, placeholder, replacement); } // 2. 替换表格中的占位符（新增核心逻辑） for (XWPFTable table : document.getTables()) { // 遍历所有表格 for (XWPFTableRow row : table.getRows()) { // 遍历表格的所有行 for (XWPFTableCell cell : row.getTableCells()) { // 遍历行的所有单元格 for (XWPFParagraph paragraph : cell.getParagraphs()) { // 遍历单元格内的所有段落 replaceRunInParagraph(paragraph, placeholder, replacement); // 替换段落中的占位符 } } } } } /** * 替换单个段落中所有 Run 里的占位符（抽取通用逻辑，避免重复代码） */ private static void replaceRunInParagraph(XWPFParagraph para, String placeholder, String replacement) { List<XWPFRun> runs = para.getRuns(); int runCount = runs.size(); // 情况1：段落只有1个 Run（直接替换） if (runCount == 1) { XWPFRun run = runs.get(0); String text = run.getText(0); if (text != null && text.contains(placeholder)) { run.setText(text.replace(placeholder, replacement), 0); } return; } // 情况2：段落有多个 Run（合并文本后替换） StringBuilder mergedText = new StringBuilder(); // 第一步：合并所有 Run 的文本 for (XWPFRun run : runs) { String text = run.getText(0); if (text != null) { mergedText.append(text); } } // 检查合并后的文本是否包含占位符 String finalText = mergedText.toString(); if (!finalText.contains(placeholder)) { return; // 不包含则无需处理 } // 第二步：替换占位符 finalText = finalText.replace(placeholder, replacement); // 第三步：清空原有所有 Run（兼容低版本 POI 的写法） // 注意：要倒序删除，避免索引错乱 for (int i = runCount - 1; i >= 0; i--) { para.removeRun(i); } // 第四步：创建新的 Run，写入替换后的文本 XWPFRun newRun = para.createRun(); newRun.setText(finalText, 0); // （可选）复制原有文本的格式（如字体、大小、颜色） if (runCount > 0) { XWPFRun originalFirstRun = runs.get(0); // 取第一个 Run 的格式 newRun.setFontFamily(originalFirstRun.getFontFamily()); newRun.setFontSize(originalFirstRun.getFontSize()); newRun.setColor(originalFirstRun.getColor()); } } }3. 模板编辑规范占位符格式：统一使用 {{占位符名}}（如 {{name}}、{{date}}），可自定义分隔符（需同步修改代码中 placeholder 的拼接逻辑）；关键注意点：占位符必须作为一个整体输入（直接复制粘贴 {{name}}，或一次性输入完成）；避免输入一半保存、再续输的操作（会导致占位符被拆分成多个 Run，替换失败）；模板文件需保存为 .docx 格式（不支持 .doc 旧格式，如需兼容可先转成 .docx）。三、使用示例编辑模板 template.docx，内容如下：姓名：{{name}} 日期：{{date}} 项目：{{s1}} 目标：{{s16}}运行 main 方法，传入替换数据；生成的文件中，占位符会被自动替换为对应值：姓名：张三 日期：2025年11月 项目：game 目标：增效降本这套方案轻量化、无额外依赖，适合合同生成、报表导出、通知书批量制作等场景，可直接集成到 Spring Boot、SSM 等主流 Java 项目中。
-
Spring Boot 整合 Milvus 向量数据库：CRUD封装 本文围绕 Spring Boot 集成 Milvus 向量数据库展开，详细介绍了二次封装的完整方案：首先通过配置类实现 Milvus 连接池与连接参数管理，再以@CollectionName和@PrimaryKey注解建立实体与 Milvus Collection 的映射，搭配驼峰转下划线命名策略解决字段名适配问题；核心封装泛型MilvusBaseService
类，实现新增、主键查询、分页查询等通用 CRUD 方法，并针对 Milvus 无原生更新的特性，采用 “先删除后插入” 策略实现更新功能；同时提供 Lambda 查询构造器简化条件查询，辅以工具类处理主键解析等通用逻辑。文中还给出业务层 Service、Controller 的使用示例与完整配置文件，附项目 GitHub 地址，帮助开发者快速落地 Milvus 相关业务。 -
-
Java 实现Google 账号单点登录（OAuth 2.0）全流程解析 在当今的互联网应用中，单点登录（SSO）已成为提升用户体验的重要功能 —— 用户无需重复注册账号，通过常用的第三方平台（如 Google、GitHub）即可快速登录。本文将详细介绍如何基于 OAuth 2.0 协议，使用 Java 结合 JustAuth 框架实现 Google 账号单点登录，涵盖从 Google 平台配置到前后端代码落地的完整流程。一、前置知识：Google 账号登录核心原理Google 账号登录基于 OAuth 2.0 授权协议，核心流程可概括为 3 步：应用引导用户跳转至 Google 授权页面，用户完成身份验证并同意授权；Google 授权服务器向应用的回调地址返回授权码；应用通过授权码向 Google 申请访问令牌，进而获取用户基本信息，最终完成登录逻辑。本文将使用 JustAuth 框架（轻量级 OAuth 工具包）简化开发，避免重复编写 OAuth 协议相关的底层代码。二、前期准备：Google Cloud 平台服务配置要实现 Google 登录，首先需要在 Google Cloud 平台创建应用并配置授权信息，这是整个流程的基础。1. 登录 Google Cloud 平台访问 Google Cloud 控制台，使用 Google 账号登录。2. 创建 / 选择项目若已有项目：直接在顶部项目列表中选择目标项目；若新建项目：点击顶部「项目」→「新建项目」，输入项目名称（如「Java-Google-SSO-Demo」），完成创建后等待项目初始化（约 1-2 分钟）。3. 配置「OAuth 同意屏幕」新创建的项目必须先配置「同意屏幕」，否则无法创建客户端凭证。在左侧菜单找到「API 和服务」→「OAuth 同意屏幕」；选择「外部」（适用于面向公众的应用，内部应用仅适用于企业域内用户），点击「创建」；填写「应用信息」：应用名称：将显示在 Google 登录授权页面（如「我的 Java 应用」）；支持邮箱：用于接收 Google 相关通知；后续步骤（范围、测试用户、摘要）保持默认配置，点击「提交」即可（测试阶段无需审核，直接可用）。4. 创建 Client 客户端（关键！）客户端凭证（Client ID、Client Secret）是应用与 Google 授权服务器通信的身份标识，需重点配置。在左侧菜单找到「API 和服务」→「凭据」→「创建凭据」→「OAuth 客户端 ID」；应用类型选择「Web 应用」，填写名称（如「Java-Web-SSO」）；配置回调地址（Redirect URI）：这是 Google 授权成功后跳转的地址，必须与后端代码中配置的一致（如 http://localhost:8080/google-login-callback）；本地测试可添加 http://localhost:8080/*，线上环境需填写真实域名；点击「创建」，记录生成的 Client ID 和 Client Secret（后续代码会用到，切勿泄露）。三、前端实现：Google 登录按钮与跳转前端只需提供一个登录按钮，点击后跳转至后端接口，由后端引导至 Google 授权页面（避免前端直接与 Google 交互，保证安全性）。本文以 Vue 为例，其他框架（React、Angular）逻辑一致：<template> <!-- 页面中的 Google 登录按钮 --> <button class="google-login-btn" @click="handleGoogleLogin" > <i class="icon-google"></i> 用 Google 账号登录 </button> </template> <script> export default { name: 'LoginPage', methods: { /** * 处理 Google 登录点击事件 * 核心：跳转至后端接口，由后端重定向到 Google 授权页 */ handleGoogleLogin() { // 后端接口地址（需与后端服务端口一致，如本地 8080 端口） window.location.href = "http://localhost:8080/google-login"; } } }; </script> <style scoped> .google-login-btn { padding: 8px 16px; background: #4285F4; color: white; border: none; border-radius: 4px; cursor: pointer; } </style>注意：此处需使用 window.location.href 进行页面级跳转，而非异步请求（axios/fetch）—— 因为 Google 授权页面需要用户手动交互（输入账号密码、同意授权）。四、后端实现：基于 JustAuth 框架的核心逻辑后端使用 Spring Boot + JustAuth 框架，主要实现两个接口：google-login：引导用户跳转至 Google 授权页；google-login-callback：接收 Google 回调，处理授权逻辑并完成登录。1. 第一步：添加 JustAuth 依赖在 pom.xml 中引入 JustAuth 最新版本（版本可从 JustAuth GitHub 发布页 获取）：<!-- JustAuth：轻量级 OAuth 工具包，简化第三方登录开发 --> <dependency> <groupId>me.zhyd.oauth</groupId> <artifactId>JustAuth</artifactId> <version>1.16.5</version> <!-- 替换为最新版本 --> </dependency> <!-- 若使用 Spring Boot，需确保已引入 web 依赖 --> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency>2. 第二步：实现「引导授权」接口（/google-login）该接口的作用是：接收前端登录请求，生成 Google 授权地址，并将页面重定向至该地址。import me.zhyd.oauth.config.AuthConfig; import me.zhyd.oauth.model.AuthCallback; import me.zhyd.oauth.request.AuthGoogleRequest; import me.zhyd.oauth.request.AuthRequest; import me.zhyd.oauth.utils.AuthStateUtils; import org.springframework.web.bind.annotation.GetMapping; import org.springframework.web.bind.annotation.RestController; import javax.servlet.http.HttpServletResponse; import java.io.IOException; import java.net.InetSocketAddress; import java.net.Proxy; @RestController @AllArgsConstructor public class AuthController { /** * Google 登录引导：重定向至 Google 授权页 * @param response 用于重定向的响应对象 * @throws IOException 重定向异常 */ @GetMapping("/google-login") public void googleLogin(HttpServletResponse response) throws IOException { // 1. 创建 Google 授权请求对象 AuthRequest authRequest = getAuthRequest(); // 2. 生成授权地址（包含随机 State，防止 CSRF 攻击） String googleAuthUrl = authRequest.authorize(AuthStateUtils.createState()); // 3. 重定向至 Google 授权页 response.sendRedirect(googleAuthUrl); } /** * 封装 Google 授权配置（抽离为工具方法，便于复用） * @return AuthRequest 授权请求对象 */ private AuthRequest getAuthRequest() { return new AuthGoogleRequest(AuthConfig.builder() // 1. 填入 Google Cloud 配置的 Client ID .clientId("你的 Client ID") // 2. 填入 Google Cloud 配置的 Client Secret .clientSecret("你的 Client Secret") // 3. 填入 Google Cloud 配置的回调地址（必须一致！） .redirectUri("http://localhost:8080/google-login-callback") // 4. （可选）国内环境配置代理（Google 服务需科学上网） .httpConfig(HttpConfig.builder() .timeout(15000) // 超时时间：15秒 .proxy(new Proxy(Proxy.Type.HTTP, new InetSocketAddress("127.0.0.1", 7897))) // 本地代理地址 .build()) .build()); } }关键说明：AuthStateUtils.createState()：生成随机 State 参数，用于防止跨站请求伪造（CSRF）攻击，Google 会在回调时带回该参数，JustAuth 会自动校验；代理配置：国内环境访问 Google 服务需配置代理（如 Clash、V2Ray），需将 host 和 port 替换为本地代理的实际参数；Client ID/Secret/Redirect URI：必须与 Google Cloud 配置完全一致，否则会报「无效客户端」或「回调地址不匹配」错误。3. 第三步：实现「回调处理」接口（/google-login-callback）用户在 Google 授权页完成操作后，Google 会将页面重定向至我们配置的回调地址，并携带 授权码（code）和 State 参数。该接口需完成以下逻辑：接收 Google 回调参数；通过 JustAuth 解析授权码，获取用户信息；结合业务逻辑完成登录（如创建用户、生成自定义 Token）；重定向至前端首页（携带自定义 Token）。import me.zhyd.oauth.model.AuthResponse; import org.springframework.beans.factory.annotation.Value; import org.springframework.web.bind.annotation.GetMapping; import org.springframework.web.bind.annotation.RestController; import javax.servlet.http.HttpServletResponse; import java.io.IOException; @RestController public class AuthController { // 从配置文件读取前端首页地址（如：http://localhost:8081/home?token=） @Value("${login.redirect.page}") private String loginRedirectPage; // 注入业务层服务（处理用户登录逻辑） private final AuthService authService; public AuthController(AuthService authService) { this.authService = authService; } /** * Google 登录回调：处理授权逻辑，完成登录 * @param callback Google 回调参数（包含 code、state 等） * @param response 用于重定向至前端首页 * @throws IOException 重定向异常 */ @GetMapping("/google-login-callback") public void googleLoginCallback(AuthCallback callback, HttpServletResponse response) throws IOException { // 1. 创建授权请求对象（复用之前的配置） AuthRequest authRequest = getAuthRequest(); // 2. 解析回调参数，获取 Google 用户信息（JustAuth 自动处理 code 换 token、拉取用户信息） AuthResponse authResponse = authRequest.login(callback); // 3. 业务层处理：结合 Google 用户信息完成登录（核心逻辑） // 自定义 VO：包含系统生成的 Token、用户信息等 AuthLoginRespVO loginResult = authService.doGoogleLogin(authResponse); // 4. 重定向至前端首页，并携带系统 Token（前端通过 Token 验证登录状态） response.sendRedirect(loginRedirectPage + loginResult.getAccessToken()); } // （省略 getAuthRequest() 方法，与上文一致） }4. 补充：业务层登录逻辑（AuthService）doGoogleLogin 方法是业务核心，需根据项目需求实现（如「用户首次登录自动创建账号」「已存在用户直接关联登录」）。以下是一个简化示例：import me.zhyd.oauth.model.AuthResponse; import me.zhyd.oauth.model.AuthUser; import org.springframework.stereotype.Service; @Service public class AuthService { /** * Google 登录业务逻辑 * @param authResponse JustAuth 返回的 Google 用户信息 * @return AuthLoginRespVO 系统登录结果（含 Token） */ public AuthLoginRespVO doGoogleLogin(AuthResponse authResponse) { // 1. 解析 Google 用户信息（AuthUser 包含用户名、邮箱、头像等） AuthUser googleUser = (AuthUser) authResponse.getData(); String googleOpenId = googleUser.getUuid(); // Google 用户唯一标识（OpenID） String googleEmail = googleUser.getEmail(); // Google 邮箱（需用户授权才能获取） // 2. 数据库查询：判断用户是否已关联 Google 账号 User existingUser = userMapper.selectByGoogleOpenId(googleOpenId); User loginUser; if (existingUser != null) { // 3. 已关联用户：直接更新登录时间等信息 existingUser.setLastLoginTime(new Date()); userMapper.updateById(existingUser); loginUser = existingUser; } else { // 4. 未关联用户：创建新用户（或引导绑定已有账号） loginUser = new User(); loginUser.setGoogleOpenId(googleOpenId); loginUser.setUsername(googleUser.getNickname()); loginUser.setEmail(googleEmail); loginUser.setAvatar(googleUser.getAvatar()); loginUser.setCreateTime(new Date()); userMapper.insert(loginUser); } // 5. 生成系统自定义 Token（如 JWT Token） String systemToken = jwtUtils.generateToken(loginUser.getId()); // 6. 返回登录结果（Token + 用户基本信息） return new AuthLoginRespVO() .setAccessToken(systemToken) .setUsername(loginUser.getUsername()) .setAvatar(loginUser.getAvatar()); } }五、整体流程回顾用户点击前端「Google 登录」按钮，跳转至后端 /google-login 接口；后端生成 Google 授权地址，重定向至 Google 授权页；用户在 Google 页输入账号密码，同意授权后，Google 重定向至后端 /google-login-callback 接口，并携带 code；后端通过 code 向 Google 申请 Token，拉取用户信息；后端结合用户信息完成登录逻辑，生成系统 Token；后端重定向至前端首页，携带 Token；前端解析 Token，验证登录状态，跳转至首页。六、常见问题与注意事项回调地址不匹配：检查 Google Cloud 配置的 Redirect URI 与后端 redirectUri 是否完全一致（包括协议、域名、端口）；国内环境无法访问 Google：需配置代理（如上文的 httpConfig），确保后端服务能正常调用 Google 授权接口；用户信息无法获取：需在 Google Cloud「OAuth 同意屏幕」中添加「邮箱」「个人资料」等权限范围；State 验证失败：JustAuth 会自动校验 State，若报错需检查是否在授权过程中修改了 State 参数；Client Secret 泄露风险：Client Secret 需存储在后端配置文件（如 application.yml），切勿暴露在前端代码中。七、总结本文基于 OAuth 2.0 协议和 JustAuth 框架，实现了 Google 账号单点登录的完整流程，核心在于「Google 平台配置」「授权引导」「回调处理」三个环节。JustAuth 框架极大简化了 OAuth 协议的底层实现，让开发者可以专注于业务逻辑（如用户关联、Token 生成）。实际项目中，还可根据需求扩展功能，如「账号绑定」「登录日志记录」「Token 过期刷新」等。希望本文能为你的第三方登录开发提供参考！
