仅引入tenant-scp-neo时本地测试出现NoClassDefFoundError

架构老林

2026-5-22

解决SAP Neo SCP多租户实现中的NoClassDefFoundError问题

我之前在SAP Neo环境里折腾多租户功能时也碰到过一模一样的问题，这个错误大概率是依赖不全、版本兼容问题或者运行时上下文缺失导致的，咱们一步步来排查解决：

补全核心依赖
tenant-scp-neo本身依赖SAP Cloud Platform的核心基础库，有时候Maven的依赖传递可能因为配置或网络问题没拉全。建议你把相关的核心依赖也显式加到POM里，保证依赖链完整：

<dependency>
    <groupId>com.sap.cloud.s4hana.cloudplatform</groupId>
    <artifactId>core</artifactId>
    <version>1.9.5</version>
</dependency>
<dependency>
    <groupId>com.sap.cloud.s4hana.cloudplatform</groupId>
    <artifactId>tenant</artifactId>
    <version>1.9.5</version>
</dependency>

配置Neo运行时的多租户开关
在SAP Neo环境中，应用需要明确启用多租户支持。打开你的neo-app.json配置文件，添加多租户相关的运行时属性：
```
{
  "properties": {
    "cloudplatform.tenant.enabled": true
  }
}
```

注意测试代码的运行上下文
如果你是在本地JUnit测试里直接调用TenantAccessor.getCurrentTenant()，会因为缺少Neo运行时的上下文环境报错。这种情况下需要引入测试专用依赖并手动初始化租户上下文：
先加测试依赖：

<dependency>
    <groupId>com.sap.cloud.s4hana.cloudplatform</groupId>
    <artifactId>tenant-scp-neo-test</artifactId>
    <version>1.9.5</version>
    <scope>test</scope>
</dependency>

然后在测试类里初始化上下文：

@Before
public void setUpTenantContext() {
    ScpNeoTenantContext tenantContext = new ScpNeoTenantContext();
    TenantAccessor.setTenantContext(tenantContext);
    // 设置测试用的租户ID
    tenantContext.setCurrentTenant(new DefaultTenant("test-tenant-id-001"));
}