Apache Karaf调用Android Publisher遇OpenCensus类找不到问题求助

Let's break down what's happening here and how to fix it—this is a classic OSGi classloader issue mixed with missing runtime dependencies for OpenCensus.

Why You're Seeing These Errors #

1. First request: ClassNotFoundException: io.opencensus.trace.propagation.TextFormat
   Even though you've included opencensus-api and confirmed the package is exported in Karaf, the opencensus-contrib-http-util bundle might not be properly importing that package from the opencensus-api bundle. OSGi requires explicit import/export between bundles, so if the import isn't resolved, the class can't be loaded.

2. Subsequent requests: NoClassDefFoundError: Could not initialize class com.google.api.client.http.OpenCensusUtils
   Once a class fails to initialize (like when TextFormat couldn't be found), the JVM marks it as permanently failed—any subsequent attempts to use it will throw this error instead of retrying the load.

The Root Cause: Missing OpenCensus Implementation #

The critical piece you're missing is the OpenCensus runtime implementation. The opencensus-api module only defines interfaces (like Tracer and TextFormat), but doesn't provide a concrete implementation. When OpenCensusUtils.getTracer() runs, it needs a working implementation to initialize properly.

Step-by-Step Fixes #

1. Add the OpenCensus Implementation Dependency

Add this to your pom.xml to include the runtime implementation:

<dependency>
    <groupId>io.opencensus</groupId>
    <artifactId>opencensus-impl</artifactId>
    <version>0.22.1</version>
    <scope>runtime</scope> <!-- Mark as runtime since it's an implementation detail -->
</dependency>

This bundle provides the concrete Tracer implementation that OpenCensusUtils needs to initialize successfully.

2. Verify OSGi Bundle Import/Export Resolutions

In Karaf, run these commands to confirm everything is wired correctly:

• List all OpenCensus bundles:
  bundle:list | grep opencensus
  Ensure all three bundles (opencensus-api, opencensus-impl, opencensus-contrib-http-util) are present and in Active state.
• Check the import packages for opencensus-contrib-http-util:
  bundle:headers <http-util-bundle-id>
  Look for Import-Package and confirm io.opencensus.trace.propagation is listed and marked as resolved (not missing).

If the import is missing, you might need to explicitly declare it in your bundle's manifest (via Maven's maven-bundle-plugin):

<plugin>
    <groupId>org.apache.felix</groupId>
    <artifactId>maven-bundle-plugin</artifactId>
    <configuration>
        <instructions>
            <Import-Package>
                io.opencensus.trace.propagation;version="[0.22,0.23)",
                * <!-- Keep other imports -->
            </Import-Package>
        </instructions>
    </configuration>
</plugin>

3. Eliminate Version Conflicts

Double-check that no other bundles in your Karaf instance are pulling in a different version of OpenCensus. Run bundle:tree <your-androidpublisher-bundle-id> to see the dependency tree and ensure all OpenCensus-related dependencies are pinned to 0.22.1.

4. Test the Fix

After adding the opencensus-impl dependency and verifying bundle states, redeploy your module and test the purchase validation request again. The initialization should complete without errors, and subsequent requests will work as expected.

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