Dependencies and Versions Used

Oct 13, 2025 by wbrum.org 125 views

Introduction

In this article, we will discuss an issue that arises when using Springwolf-UI with Springwolf-AMQP. The problem is related to an unsupported-protocol error that appears in the Springwolf-UI interface. This error is accompanied by a disabled Publish button, which prevents users from publishing messages to the AMQP server. We will explore the possible causes of this issue and provide a solution to resolve it.

Describe the Bug

The issue is encountered when the Springwolf-AMQP plugin is enabled, and the protocol is set to amqp. The configuration for the AMQP server is as follows:

spring.rabbitmq.host=localhost
spring.rabbitmq.port=5672
springwolf.enabled=true
springwolf.docket.info.title=Terraform Async Request APIs
springwolf.docket.info.version=@project.version@
springwolf.docket.info.description=Terraform Async Request APIs
springwolf.docket.base-package=org.eclipse.xpanse.terra.boot.api.queue
springwolf.docket.servers.amqp-server.protocol=amqp
springwolf.docket.servers.amqp-server.host=${spring.rabbitmq.host}:${spring.rabbitmq.port}
springwolf.plugin.amqp.publishing.enabled=true
springwolf.ui.defaults.show-bindings=true
springwolf.ui.defaults.show-headers=true
logging.level.io.github.springwolf=DEBUG

However, instead of displaying the amqp protocol, the Springwolf-UI interface shows an unsupported-protocol error. The Publish button is also disabled, preventing users from publishing messages to the AMQP server.

Dependencies and Versions Used

The following dependencies and versions are used in this scenario:

springwolf-core version 1.11.0
springwolf-amqp version 1.11.0
springwolf-ui version 1.11.0

Code Example

To reproduce this issue, you can use the Springwolf examples repository. You can adjust one of the examples to reproduce the scenario:

Fork the Springwolf-core repository in GitHub and git clone it.
Adjust classes, etc. in one of the Springwolf-examples.
Push your local changes to a branch on your fork (git commit, git push).
Open a Pull Request (a notification will appear in your fork as soon as you push your branch), the title should include reproduce and ideally the link to the issue.

Stack Trace and Error Logs

The following stack trace and error logs are related to this issue:

Request: GET /springwolf/unsupported-protocol/publish
 Response: 404 Not Found Duration: 4ms

Possible Causes

The possible causes of this issue are:

Incorrect protocol configuration: The protocol configuration in the Springwolf-UI interface may be incorrect, leading to the unsupported-protocol error.
Missing dependencies: The required dependencies for the Springwolf-AMQP plugin may be missing, causing the unsupported-protocol error.
Configuration issues: There may be configuration issues with the Springwolf-AMQP plugin, leading to the unsupported-protocol error.

Solution

To resolve this issue, you can try the following solutions:

Check the protocol configuration: Verify that the protocol configuration in the Springwolf-UI interface is correct.
Add missing dependencies: Ensure that the required dependencies for the Springwolf-AMQP plugin are included in the project.
Review configuration issues: Review the configuration of the Springwolf-AMQP plugin to ensure that it is correct.

Conclusion

In this article, we discussed an issue that arises when using Springwolf-UI with Springwolf-AMQP. The problem is related to an unsupported-protocol error that appears in the Springwolf-UI interface. We explored the possible causes of this issue and provided a solution to resolve it. By following the solutions outlined in this article, you should be able to resolve the unsupported-protocol error and enable the Publish button in the Springwolf-UI interface.

Additional Tips

Verify the protocol configuration: Ensure that the protocol configuration in the Springwolf-UI interface is correct.
Check for missing dependencies: Verify that the required dependencies for the Springwolf-AMQP plugin are included in the project.
Review configuration issues: Review the configuration of the Springwolf-AMQP plugin to ensure that it is correct.

References

Springwolf-UI documentation
Springwolf-AMQP documentation
Springwolf-examples repository
Q&A: Unsupported Protocol in Springwolf-UI when Springwolf-AMQP is Used ====================================================================

Q: What is the cause of the "unsupported-protocol" error in Springwolf-UI when using Springwolf-AMQP?

A: The "unsupported-protocol" error in Springwolf-UI when using Springwolf-AMQP is caused by an incorrect protocol configuration or missing dependencies for the Springwolf-AMQP plugin.

Q: How do I verify the protocol configuration in Springwolf-UI?

A: To verify the protocol configuration in Springwolf-UI, follow these steps:

Check the springwolf.docket.servers.amqp-server.protocol property in your application configuration.
Ensure that the protocol is set to the correct value (e.g., amqp).
Verify that the springwolf.plugin.amqp.publishing.enabled property is set to true.

Q: What are the required dependencies for the Springwolf-AMQP plugin?

A: The required dependencies for the Springwolf-AMQP plugin are:

springwolf-core version 1.11.0
springwolf-amqp version 1.11.0
spring-rabbit version 2.3.12

Q: How do I add missing dependencies to my project?

A: To add missing dependencies to your project, follow these steps:

Add the required dependencies to your pom.xml file (if you're using Maven) or your build.gradle file (if you're using Gradle).
Ensure that the dependencies are included in the project's classpath.
Verify that the dependencies are correctly configured.

Q: What are some common configuration issues with the Springwolf-AMQP plugin?

A: Some common configuration issues with the Springwolf-AMQP plugin include:

Incorrect protocol configuration
Missing dependencies
Incorrect configuration of the springwolf.plugin.amqp.publishing.enabled property
Incorrect configuration of the springwolf.docket.servers.amqp-server.host property

Q: How do I resolve configuration issues with the Springwolf-AMQP plugin?

A: To resolve configuration issues with the Springwolf-AMQP plugin, follow these steps:

Review the plugin's documentation to ensure that you're using the correct configuration.
Verify that the plugin's dependencies are correctly configured.
Check the plugin's logs for any error messages or warnings.
Consult the plugin's community forums or seek help from a plugin expert.

Q: Can I use the Springwolf-AMQP plugin with other messaging protocols?

A: Yes, you can use the Springwolf-AMQP plugin with other messaging protocols, such as RabbitMQ or Apache Kafka. However, you'll need to configure the plugin accordingly and ensure that the required dependencies are included in the project.

Q: How do I troubleshoot issues with the Springwolf-AMQP plugin?

A: To troubleshoot issues with the Springwolf-AMQP plugin, follow these steps:

Review the plugin's logs for any error messages or warnings.
Check the plugin's configuration to ensure that it's correctly set up.
Verify that the plugin's dependencies are correctly configured.
Consult the plugin's community forums or seek help from a plugin expert.

Q: Can I use the Springwolf-AMQP plugin with other Spring Boot applications?

A: Yes, you can use the Springwolf-AMQP plugin with other Spring Boot applications. However, you'll need to ensure that the plugin's dependencies are correctly configured and that the plugin is correctly integrated with the other application.