Springboot 3集成最新版activiti 8.6,一次成功,完美避坑

笔者基于activiti 5.23开发了一个深度定制的流程引擎AntFlow,由于activiti5官方已经放弃更新了,因此长远来看,activiti5迟早要放弃,升级到新版本是尽早都要做的。而升级就面临着选择（activiti和flowable分家）笔者经过持续观察和调研.最终决定放弃升级到flowable,而是选择升级到activiti最新版,目前是8.6版本.由于activiti6以后资料较少,为了帮助广大开发者快速投入到activiti最新版本使用,笔者决定将自己升级过程中的一些经验,教训,关键步骤等记录下来写成博客形式分享出来.

activiti专业性强,学习曲线较为陡峭,入门写demo容易深入难,后期维护也比较难.为了解决这些难题,笔者基于activiti开发了一个深度定制的，可快速上手的，适合中国式办公场景的流程引擎AntFlow。详细介绍可以打开链接 github地址 gitee地址 前端设计器地址

关于activiti8的介绍可以看我的另一篇文章

Activiti8 面向云原生的activiti版本介绍

下面开始正文，介绍如何将activiti 8.6集成到spring 3中。正文中加粗的部分需要特别关注，如果不注意可能最终和笔者执行的结果不一样。还有就是看的时候最好不要跳跃，本文已经力求减少内容，快速将核心部分展示出来。如果你的项目是一个全新项目，则可以跳过所有，直接复制maven pom文件即可

第一步：创建springboot项目

这一步不再详细介绍，如果使用的是idea专业版，可以直接在idea中通过集成的脚手架创建。我使用的是idea社区版，没有集成springboot项目创建脚本架功能。我使用是spring boot官网脚手架,需要注意的是，activiti8以后只支持java17以上版本，而activiti 8.6 只支持java 21以上版本并且是强制检测的。如果想体验activiti 8.6，应确保你的电脑上安装的jdk21。

另外有一点需要注意的是，截至写本文，springboot最新版本是3.4，但是activiti8.6并不能支持这个版本。（笔者集成3.4的时候出现了错误，尝试解决最终没有解决掉，最后下载下来源码看官方使用的是spring boot 3.3，因此笔者最终选择的是springboot 3.3.2，当然你也可以折腾折腾，可能最后问题就解决了，本文题目是一次成功，目的是避开各种坑，快速将二者集成。

使用springboot 3.3，使用springboot 3.3，使用springboot 3.3重要的事情说三遍

第二步，添加指定仓库

由于activiti7以后（具体哪个版本不清楚了），官方不再将构建制品发布到maven中央仓库了，而是发布在了alfresco仓库，这就需要我们仓库才能正确下载依赖.在pom中添加repositories标签，然后再添加repository标签。如果repositories已经有了，切不要再添加，而是将repository标签和里面的内容复制进去。最终效果如下

activiti-releases

https://artifacts.alfresco.com/nexus/content/repositories/activiti-releases

第三步，添加依赖管理

activiti本身是一个庞大的系统，存在着众多依赖。虽然这一步不是必须的，但是强烈建议添加上。如果仅仅是跑个demo可能没什么问题，如果后面依赖越来越多了，就可能出现冲突，这时候可能就会花费更多时间来解决

org.activiti

activiti-dependencies

8.6.0

import

pom

第四步，添加activiti 8.6

org.activiti

activiti-spring-boot-starter

8.6.0

需要注意的是activiti必须依赖数据库，如果是简单的demo不想配置数据库，可以使用h2，activiti也是支持的。但是如果想要在生产中使用，h2肯定是不行的，我们这里配置一个生产可用的。

com.mysql

mysql-connector-j

runtime

第五步添加其它依赖

比如说生产中一般是spring boot web项目，我们往往还使用lombok插件，这时候自己添加即可。

完整pom

下面贴上完整maven pom

xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">

4.0.0

org.springframework.boot

spring-boot-starter-parent

3.3.2

org.openoa

antflow-future

0.0.1-SNAPSHOT

antflow-future

AntFlow next version with activiti 8

21

org.springframework.boot

spring-boot-starter-data-jdbc

org.springframework.boot

spring-boot-starter-web

com.mysql

mysql-connector-j

runtime

org.projectlombok

lombok

true

org.activiti

activiti-spring-boot-starter

8.6.0

org.springframework.boot

spring-boot-starter-test

test

activiti-releases

https://artifacts.alfresco.com/nexus/content/repositories/activiti-releases

org.activiti

activiti-dependencies

8.6.0

import

pom

org.springframework.boot

spring-boot-maven-plugin

org.projectlombok

lombok

mysql数据库配置

spring:

datasource:

driver-class-name: com.mysql.cj.jdbc.Driver

url: jdbc:mysql://124.222.106.239:3306/activiti8?nullCatalogMeansCurrent=true

username: root（您的账号）

password: 123456（替换成您的密码）

activiti:

database-schema-update: true

db-history-used: true

history-level: full

check-process-definitions: true

需要注意的是，数据库要提前创建好，名字可以是任意，不是必须叫activiti8

配置spring security

为了能够让大家快速启动项目体验，这里就不真正按生产环境来配置了。而是复制了官方demo的内容，后面再开章节介绍如何配置spring security连接自己的数据库获取用户信息

activiti7以后深度集成了spring security，网上很多方法都不是很靠谱。其实没有必要把它去除掉，你的项目可以完全不使用springsecurity，只在activiti相关的业务里面使用就行了。后面会开章节讲解如何跳过spring security认证。（后端代码你不配置使用它的权限验证自然也不会用到，前端请求路由设置全部跳过，让自己已有系统的权限管理框架来接管）

添加配置

package org.openoa.antflow_future.config;

import org.activiti.engine.impl.util.ProcessDefinitionUtil;

import org.slf4j.Logger;

import org.slf4j.LoggerFactory;

import org.springframework.context.annotation.Bean;

import org.springframework.context.annotation.Configuration;

import org.springframework.security.core.authority.SimpleGrantedAuthority;

import org.springframework.security.core.userdetails.User;

import org.springframework.security.core.userdetails.UserDetailsService;

import org.springframework.security.crypto.bcrypt.BCryptPasswordEncoder;

import org.springframework.security.crypto.password.PasswordEncoder;

import org.springframework.security.provisioning.InMemoryUserDetailsManager;

import java.util.Arrays;

import java.util.List;

import java.util.stream.Collectors;

@Configuration

public class AntFlowSecurityConfiguration {

private Logger logger = LoggerFactory.getLogger(AntFlowSecurityConfiguration.class);

@Bean

public UserDetailsService myUserDetailsService() {

InMemoryUserDetailsManager inMemoryUserDetailsManager = new InMemoryUserDetailsManager();

//这里添加用户，后面处理流程时用到的任务负责人，需要添加在这里

String[][] usersGroupsAndRoles = {

{"jack", "password", "ROLE_ACTIVITI_USER", "GROUP_activitiTeam"},

{"rose", "password", "ROLE_ACTIVITI_USER", "GROUP_activitiTeam"},

{"tom", "password", "ROLE_ACTIVITI_USER", "GROUP_activitiTeam"},

{"other", "password", "ROLE_ACTIVITI_USER", "GROUP_otherTeam"},

{"system", "password", "ROLE_ACTIVITI_USER"},

{"admin", "password", "ROLE_ACTIVITI_ADMIN"},

};

for (String[] user : usersGroupsAndRoles) {

List authoritiesStrings = Arrays.asList(Arrays.copyOfRange(user, 2, user.length));

logger.info("> Registering new user: " + user[0] + " with the following Authorities[" + authoritiesStrings + "]");

inMemoryUserDetailsManager.createUser(new User(user[0], passwordEncoder().encode(user[1]),

authoritiesStrings.stream().map(s -> new SimpleGrantedAuthority(s)).collect(Collectors.toList())));

}

return inMemoryUserDetailsManager;

}

@Bean

public PasswordEncoder passwordEncoder() {

return new BCryptPasswordEncoder();

}

}

添加工具类

package org.openoa.antflow_future.util;

import org.slf4j.Logger;

import org.slf4j.LoggerFactory;

import org.springframework.beans.factory.annotation.Autowired;

import org.springframework.beans.factory.annotation.Qualifier;

import org.springframework.security.core.Authentication;

import org.springframework.security.core.GrantedAuthority;

import org.springframework.security.core.context.SecurityContextHolder;

import org.springframework.security.core.context.SecurityContextImpl;

import org.springframework.security.core.userdetails.UserDetails;

import org.springframework.security.core.userdetails.UserDetailsService;

import org.springframework.stereotype.Component;

import java.util.Collection;

@Component

public class SecurityUtil {

private Logger logger = LoggerFactory.getLogger(SecurityUtil.class);

@Autowired

@Qualifier("myUserDetailsService")

private UserDetailsService userDetailsService;

public void logInAs(String username) {

UserDetails user = userDetailsService.loadUserByUsername(username);

if (user == null) {

throw new IllegalStateException("User " + username + " doesn't exist, please provide a valid user");

}

logger.info("> Logged in as: " + username);

SecurityContextHolder.setContext(

new SecurityContextImpl(

new Authentication() {

@Override

public Collection getAuthorities() {

return user.getAuthorities();

}

@Override

public Object getCredentials() {

return user.getPassword();

}

@Override

public Object getDetails() {

return user;

}

@Override

public Object getPrincipal() {

return user;

}

@Override

public boolean isAuthenticated() {

return true;

}

@Override

public void setAuthenticated(boolean isAuthenticated) throws IllegalArgumentException { }

@Override

public String getName() {

return user.getUsername();

}

}));

org.activiti.engine.impl.identity.Authentication.setAuthenticatedUserId(username);

}

}

启动项目

这时候如果你是按照上面步骤配置的，项目应该是能正常跑起来了

注意点

java版本需要是java21，并在idea里正确配置项目的jdk版本springboot 版本为3.3.x如果您的电脑上装有多个jdk版本，默认的不是java21.项目打包的时候使用idea maven工具里的package，而不是能使用命令行的mvn package，命令行会使用你java home配置的jdk版本。