{"id":18431086,"url":"https://github.com/purgeteam/activiti-starter","last_synced_at":"2026-04-02T02:53:38.487Z","repository":{"id":37333792,"uuid":"210550209","full_name":"purgeteam/activiti-starter","owner":"purgeteam","description":"activiti6-7练习","archived":false,"fork":false,"pushed_at":"2022-06-21T02:01:03.000Z","size":44,"stargazers_count":18,"open_issues_count":3,"forks_count":6,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-04-07T18:42:59.045Z","etag":null,"topics":["activiti6","activiti7","springboot2"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/purgeteam.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-09-24T08:22:47.000Z","updated_at":"2024-03-28T12:35:53.000Z","dependencies_parsed_at":"2022-08-18T03:55:53.439Z","dependency_job_id":null,"html_url":"https://github.com/purgeteam/activiti-starter","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/purgeteam/activiti-starter","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/purgeteam%2Factiviti-starter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/purgeteam%2Factiviti-starter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/purgeteam%2Factiviti-starter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/purgeteam%2Factiviti-starter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/purgeteam","download_url":"https://codeload.github.com/purgeteam/activiti-starter/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/purgeteam%2Factiviti-starter/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279050481,"owners_count":26093504,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-15T02:00:07.814Z","response_time":56,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["activiti6","activiti7","springboot2"],"created_at":"2024-11-06T05:23:29.632Z","updated_at":"2025-10-15T04:52:12.957Z","avatar_url":"https://github.com/purgeteam.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Springboot2.1.x配置Activiti7单独数据源问题\n## 简介\n\n最近基于最新的`Activiti7`配置了`SpringBoot2`。\n简单上手使用了一番。发现市面上解决`Activiti7`的教程很少，采坑也比较多，在`Activiti6`配置数据源和`Activiti7`有所区别，基于`Activiti6`在`Activiti7`里是无法正常使用的。接下来让我们看下区别。\n\n## 问题\n\n### `Activiti6`多数据源配置\n\n6的配置比较简单点。\n\n1. 先加入配置：\n\n```\n# activiti 数据源\nspring.datasource.activiti.driver=com.mysql.jdbc.Driver\nspring.datasource.activiti.url=jdbc:mysql://10.1.1.97:3311/test-activiti7-db?useUnicode=true\u0026characterEncoding=utf8\u0026useSSL=false\u0026allowMultiQueries=true\nspring.datasource.activiti.username=root\nspring.datasource.activiti.password=Rtqw123OpnmER\nspring.datasource.activiti.driverClassName=com.mysql.jdbc.Driver\n```\n\n2. 用`@ConfigurationProperties`加载以`spring.datasource.activiti`开头的`DataSource`。\n\n3. 创建`ActivitiConfig`继承`AbstractProcessEngineAutoConfiguration`方法注入`SpringProcessEngineConfiguration`bean,调用`AbstractProcessEngineAutoConfiguration#baseSpringProcessEngineConfiguration`方法把创建的数据源注入。\n\n```\n@Configuration\npublic class ActivitiConfig extends AbstractProcessEngineAutoConfiguration {\n\n  @Bean\n  @ConfigurationProperties(prefix = \"spring.datasource.activiti\")\n  public DataSource activitiDataSource() {\n    return DataSourceBuilder.create().build();\n  }\n\n  @Bean\n  public SpringProcessEngineConfiguration springProcessEngineConfiguration(\n      PlatformTransactionManager transactionManager,\n      SpringAsyncExecutor springAsyncExecutor) throws IOException {\n\n    return baseSpringProcessEngineConfiguration(\n        activitiDataSource(),\n        transactionManager,\n        springAsyncExecutor);\n  }\n}\n```\n\n`Activiti6`的数据源已经配置完成，如果是7的话会发现`AbstractProcessEngineAutoConfiguration#baseSpringProcessEngineConfiguration`方法已经不存在了，我们需要产考源码构建方式改造一番。\n\n## 修复\n\n### `Activiti7`多数据源配置\n\n配置还是要上面的。\n\n1. 创建`ActivitiConfig`继承`AbstractProcessEngineAutoConfiguration`方法注入`SpringProcessEngineConfiguration`bean。\n\n2. 用`@ConfigurationProperties`加载以`spring.datasource.activiti`开头的`DataSource`\n\n```\n@Configuration\npublic class ActivitiConfig extends AbstractProcessEngineAutoConfiguration {\n  \n  @Bean\n  @ConfigurationProperties(prefix = \"spring.datasource.activiti\")\n  public DataSource activitiDataSource() {\n    return DataSourceBuilder.create().build();\n  }\n  \n  ...略\n}\n```\n\n3. `SpringProcessEngineConfiguration`注入方式改为下面：\n\n```\n  @Bean\n  @Primary\n  public SpringProcessEngineConfiguration springProcessEngineConfiguration(\n      PlatformTransactionManager transactionManager,\n      SpringAsyncExecutor springAsyncExecutor,\n      ActivitiProperties activitiProperties,\n      ProcessDefinitionResourceFinder processDefinitionResourceFinder,\n      @Autowired(required = false) DefaultActivityBehaviorFactoryMappingConfigurer processEngineConfigurationConfigurer,\n      @Autowired(required = false) List\u003cProcessEngineConfigurator\u003e processEngineConfigurators,\n      UserGroupManager userGroupManager,\n      DataSource dataSource) throws IOException {\n\n    SpringProcessEngineConfiguration conf = new SpringProcessEngineConfiguration();\n    conf.setConfigurators(processEngineConfigurators);\n    configureProcessDefinitionResources(processDefinitionResourceFinder,\n        conf);\n    conf.setDataSource(dataSource);\n    conf.setTransactionManager(transactionManager);\n\n    if (springAsyncExecutor != null) {\n      conf.setAsyncExecutor(springAsyncExecutor);\n    }\n    conf.setDeploymentName(activitiProperties.getDeploymentName());\n    conf.setDatabaseSchema(activitiProperties.getDatabaseSchema());\n    conf.setDatabaseSchemaUpdate(activitiProperties.getDatabaseSchemaUpdate());\n    conf.setDbHistoryUsed(activitiProperties.isDbHistoryUsed());\n    conf.setAsyncExecutorActivate(activitiProperties.isAsyncExecutorActivate());\n    if (!activitiProperties.isAsyncExecutorActivate()) {\n      ValidatorSet springBootStarterValidatorSet = new ValidatorSet(\"activiti-spring-boot-starter\");\n      springBootStarterValidatorSet.addValidator(new AsyncPropertyValidator());\n      if (conf.getProcessValidator() == null) {\n        ProcessValidatorImpl processValidator = new ProcessValidatorImpl();\n        processValidator.addValidatorSet(springBootStarterValidatorSet);\n        conf.setProcessValidator(processValidator);\n      } else {\n        conf.getProcessValidator().getValidatorSets().add(springBootStarterValidatorSet);\n      }\n    }\n    conf.setMailServerHost(activitiProperties.getMailServerHost());\n    conf.setMailServerPort(activitiProperties.getMailServerPort());\n    conf.setMailServerUsername(activitiProperties.getMailServerUserName());\n    conf.setMailServerPassword(activitiProperties.getMailServerPassword());\n    conf.setMailServerDefaultFrom(activitiProperties.getMailServerDefaultFrom());\n    conf.setMailServerUseSSL(activitiProperties.isMailServerUseSsl());\n    conf.setMailServerUseTLS(activitiProperties.isMailServerUseTls());\n\n    if (userGroupManager != null) {\n      conf.setUserGroupManager(userGroupManager);\n    }\n\n    conf.setHistoryLevel(activitiProperties.getHistoryLevel());\n    conf.setCopyVariablesToLocalForTasks(activitiProperties.isCopyVariablesToLocalForTasks());\n    conf.setSerializePOJOsInVariablesToJson(activitiProperties.isSerializePOJOsInVariablesToJson());\n    conf.setJavaClassFieldForJackson(activitiProperties.getJavaClassFieldForJackson());\n\n    if (activitiProperties.getCustomMybatisMappers() != null) {\n      conf.setCustomMybatisMappers(\n          getCustomMybatisMapperClasses(activitiProperties.getCustomMybatisMappers()));\n    }\n\n    if (activitiProperties.getCustomMybatisXMLMappers() != null) {\n      conf.setCustomMybatisXMLMappers(\n          new HashSet\u003c\u003e(activitiProperties.getCustomMybatisXMLMappers()));\n    }\n\n    if (activitiProperties.getCustomMybatisXMLMappers() != null) {\n      conf.setCustomMybatisXMLMappers(\n          new HashSet\u003c\u003e(activitiProperties.getCustomMybatisXMLMappers()));\n    }\n\n    if (activitiProperties.isUseStrongUuids()) {\n      conf.setIdGenerator(new StrongUuidGenerator());\n    }\n\n    if (activitiProperties.getDeploymentMode() != null) {\n      conf.setDeploymentMode(activitiProperties.getDeploymentMode());\n    }\n\n    conf.setActivityBehaviorFactory(new DefaultActivityBehaviorFactory());\n\n    if (processEngineConfigurationConfigurer != null) {\n      processEngineConfigurationConfigurer.configure(conf);\n    }\n\n    return conf;\n  }\n\n  private void configureProcessDefinitionResources(\n      ProcessDefinitionResourceFinder processDefinitionResourceFinder,\n      SpringProcessEngineConfiguration conf) throws IOException {\n    List\u003cResource\u003e procDefResources = processDefinitionResourceFinder\n        .discoverProcessDefinitionResources();\n    if (!procDefResources.isEmpty()) {\n      conf.setDeploymentResources(procDefResources.toArray(new Resource[0]));\n    }\n  }\n```\n\n## 常见错误\n\n在以上配置中可能会有`jdbcUrl is required with driverClassName`错误\n\n解决办法如下:\n\n```\n# activiti 数据源\nspring.datasource.activiti.driver=com.mysql.jdbc.Driver\nspring.datasource.activiti.url=jdbc:mysql://10.1.1.97:3311/test-activiti7-db?useUnicode=true\u0026characterEncoding=utf8\u0026useSSL=false\u0026allowMultiQueries=true\n# url换为jdbc-url 解决jdbcUrl is required with driverClassName错误\n# 官方文档的解释是：\n# 因为连接池的实际类型没有被公开，所以在您的自定义数据源的元数据中没有生成密钥，而且在IDE中没有完成(因为DataSource接口没有暴露属性)。\n# 另外，如果您碰巧在类路径上有Hikari，那么这个基本设置就不起作用了，因为Hikari没有url属性(但是确实有一个jdbcUrl属性)。在这种情况下，您必须重写您的配置如下:\nspring.datasource.activiti.jdbc-url=${spring.datasource.activiti.url}\nspring.datasource.activiti.username=root\nspring.datasource.activiti.password=Rtqw123OpnmER\nspring.datasource.activiti.driverClassName=com.mysql.jdbc.Driver\n```\n\n## 总结\n\n`Activiti7`国内的教程不是很多，需要自己在社区里或者官方文档，源码去看了解，细心学习。\n\n\u003e 示例代码地址:[activiti-starter](https://github.com/purgeteam/activiti-starter)\n\n\u003e 作者GitHub:\n[Purgeyao](https://github.com/purgeyao) 欢迎关注\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpurgeteam%2Factiviti-starter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpurgeteam%2Factiviti-starter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpurgeteam%2Factiviti-starter/lists"}