如何在Spring Boot服务器中嵌入式运行OrientDB并启用Studio交互查询

刚好做过类似的实现，给你梳理一套完整的方案，帮你在Spring Boot里嵌入式跑OrientDB，同时用上Studio做交互和即席查询：

1. 添加必要依赖 #

首先得把OrientDB核心、Spring Boot集成包和Studio模块引入项目，这里分别给出Maven和Gradle的配置：

Maven配置（pom.xml） #

<dependencies>
    <!-- OrientDB核心库 -->
    <dependency>
        <groupId>com.orientechnologies</groupId>
        <artifactId>orientdb-core</artifactId>
        <version>3.2.26</version> <!-- 建议用最新稳定版 -->
    </dependency>
    <!-- OrientDB Spring Boot启动器 -->
    <dependency>
        <groupId>com.orientechnologies</groupId>
        <artifactId>orientdb-spring-boot-starter</artifactId>
        <version>3.2.26</version>
    </dependency>
    <!-- OrientDB Studio（运行时依赖即可） -->
    <dependency>
        <groupId>com.orientechnologies</groupId>
        <artifactId>orientdb-studio</artifactId>
        <version>3.2.26</version>
        <scope>runtime</scope>
    </dependency>
</dependencies>

Gradle配置（build.gradle） #

dependencies {
    implementation 'com.orientechnologies:orientdb-core:3.2.26'
    implementation 'com.orientechnologies:orientdb-spring-boot-starter:3.2.26'
    runtimeOnly 'com.orientechnologies:orientdb-studio:3.2.26'
}

2. 配置Spring Boot参数 #

在application.properties或application.yml里设置嵌入式数据库和Studio的相关参数：

application.properties #

# 嵌入式plocal数据库路径及账号
spring.orientdb.url=plocal:./databases/mydb
spring.orientdb.username=admin
spring.orientdb.password=admin
spring.orientdb.pool.max=20

# 启用OrientDB Studio，自定义访问路径（默认是/studio）
spring.orientdb.studio.enabled=true
spring.orientdb.studio.path=/orientdb-studio

application.yml #

spring:
  orientdb:
    url: plocal:./databases/mydb
    username: admin
    password: admin
    pool:
      max: 20
    studio:
      enabled: true
      path: /orientdb-studio

3. 自定义数据库初始化（可选但推荐） #

如果需要初始化数据库结构（比如创建类、索引），可以写一个配置类来实现：

import com.orientechnologies.orient.core.db.ODatabaseSession;
import com.orientechnologies.orient.core.db.OrientDB;
import com.orientechnologies.orient.core.db.OrientDBConfig;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

import javax.annotation.PostConstruct;

@Configuration
public class OrientDBInitializer {

    @Value("${spring.orientdb.url}")
    private String dbUrl;

    @Value("${spring.orientdb.username}")
    private String dbUsername;

    @Value("${spring.orientdb.password}")
    private String dbPassword;

    @Bean
    public OrientDB orientDB() {
        // 初始化嵌入式OrientDB实例
        return new OrientDB("plocal:./databases", OrientDBConfig.defaultConfig());
    }

    @Bean
    public ODatabaseSession databaseSession(OrientDB orientDB) {
        // 数据库不存在则创建
        if (!orientDB.exists("mydb")) {
            orientDB.create("mydb", "document");
        }
        return orientDB.open("mydb", dbUsername, dbPassword);
    }

    @PostConstruct
    public void initDbStructure() {
        // 示例：创建User顶点类及name属性
        try (ODatabaseSession session = databaseSession(orientDB())) {
            if (!session.getClass("User").exists()) {
                session.createVertexClass("User");
                session.createProperty("User", "name", String.class);
            }
        }
    }
}

4. 启动应用并访问Studio #

启动Spring Boot应用后，直接在浏览器访问你配置的Studio路径（比如http://localhost:8080/orientdb-studio），用配置的账号密码登录，就能看到你的嵌入式plocal数据库，直接在界面里做数据操作了。

5. 执行即席查询 #

在Studio中执行 #

Studio自带查询编辑器，直接输入SQL语句即可，比如：

SELECT * FROM User WHERE name = 'Alice'

在代码中执行 #

通过注入的ODatabaseSession对象，可以在业务代码里执行即席查询：

import com.orientechnologies.orient.core.db.ODatabaseSession;
import com.orientechnologies.orient.core.sql.executor.OResultSet;
import org.springframework.stereotype.Service;

@Service
public class QueryService {

    private final ODatabaseSession dbSession;

    public QueryService(ODatabaseSession dbSession) {
        this.dbSession = dbSession;
    }

    public void runAdHocQuery() {
        String query = "SELECT COUNT(*) FROM User";
        try (OResultSet resultSet = dbSession.query(query)) {
            resultSet.forEach(result -> 
                System.out.println("用户总数：" + result.getProperty("COUNT(*)"))
            );
        }
    }
}

注意事项 #

• 嵌入式模式下，数据库文件会存在你配置的本地路径（比如./databases/mydb），记得定期备份这个目录
• 生产环境一定要修改默认的admin密码，避免安全风险
• 确保Spring Boot应用对数据库目录有读写权限

内容的提问来源于stack exchange，提问作者Luis Trigueiros