Enterprise Distributed Application Service:Error code: HSF-0013

Error message

invalid route while WriteMode=unit, route : ${route}, route parameter should be: long

The ${route} variable displays the actual route value that failed validation at runtime.

Cause

HSF (High-Speed Framework) throws this error when the route attribute in a unitized routing configuration has an invalid parameter type. In unitized deployment mode (WriteMode=unit), the route attribute accepts only two types:

Any other type for the route attribute triggers this error.

Solution

1. Open the HSF service configuration where unitized routing is defined.

2. Locate the route attribute in the unitized routing configuration.

3. Change the route parameter type to long (primitive) or java.lang.Long (wrapper class).

4. Redeploy the application.

5. Verify the fix by searching the application logs for the error string:

   grep "HSF-0013" <application-log-path>

   No matches confirm that the route parameter type is valid.