使用Spring与properties文件时遇BeanDefinitionParsingException错误求助

Hey there, let's break down and fix that error you're facing:

org.springframework.beans.factory.parsing.BeanDefinitionParsingException: Configuration problem: Id is required for element 'properties' when used as a top-level tag

What's causing this? #

Spring treats the <properties> tag as a BeanDefinition when it's placed directly under the root <beans> tag (as a top-level element). For Spring to manage this bean properly, it needs a unique identifier—hence the requirement for an id attribute.

How to fix it #

You have two common solutions depending on what you're trying to achieve:

1. If you need the properties as a reusable standalone bean

Add an id attribute to your top-level <properties> tag. This lets you reference it across other beans in your configuration.

Example di.xml:

<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xsi:schemaLocation="http://www.springframework.org/schema/beans
                           http://www.springframework.org/schema/beans/spring-beans.xsd">

    <!-- Add an id to the top-level properties tag -->
    <properties id="applicationProperties">
        <prop key="db.url">jdbc:mysql://localhost:3306/mydb</prop>
        <prop key="app.env">development</prop>
    </properties>

    <!-- Reference the properties bean in another component -->
    <bean id="userRepository" class="com.example.UserRepository">
        <property name="dbUrl" value="#{applicationProperties['db.url']}"/>
    </bean>
</beans>

2. If you're setting properties for a specific bean

If the <properties> are meant to be an attribute of a single bean, nest it inside that bean's <property> tag instead of making it top-level. In this case, no id is needed.

Example di.xml:

<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xsi:schemaLocation="http://www.springframework.org/schema/beans
                           http://www.springframework.org/schema/beans/spring-beans.xsd">

    <bean id="notificationService" class="com.example.NotificationService">
        <!-- Nest properties inside the bean's property definition -->
        <property name="messageProperties">
            <properties>
                <prop key="welcome.msg">Hello, welcome!</prop>
                <prop key="error.msg">Oops, something went wrong!</prop>
            </properties>
        </property>
    </bean>
</beans>

Quick check #

Just open your di.xml file and look where your <properties> tag sits. If it's directly under <beans>, go with option 1. If it's supposed to belong to a specific bean, move it inside that bean's <property> block like option 2.

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