Spring Boot Thymeleaf 前端数值1位小数格式化及Bean报错排查

• 静态内部类的Bean名称不匹配：你把MathUtils写成主启动类的静态内部类，哪怕@Component注解生效，Spring默认对嵌套静态类生成的Bean名称会带外层类前缀，实际Bean名是springBootWebApplication.MathUtils，并非Thymeleaf中引用的mathUtils，自然抛出NoSuchBeanDefinitionException。你在main方法里能通过类名拿到Bean，是因为那是按类型匹配，和名称匹配规则无关。
• 误用@Bean注解导致启动报错：@Bean是@Configuration类中用于声明Bean的注解，需要加在“返回Bean实例的无参方法”上。你把@Bean加在带double入参的formatNumber方法上，Spring会把这个方法当成Bean定义，尝试从容器中注入名为number的double类型Bean，根本找不到对应的依赖，就会抛出“Consider defining a bean of type 'double' in your configuration”的错误。

方案1：直接用Thymeleaf内置工具（最省事，零自定义代码） #

完全不需要自己写格式化工具类，Thymeleaf内置的#numbers工具对象本身就支持小数格式化，而且不会破坏后端保留的全精度数值：
直接替换原有表格的单元格取值逻辑：

<tr th:each="value : ${allvalues}">
    <!-- 参数顺序：整数部分最少位数、整数部分分隔符、小数位数、小数部分分隔符 -->
    <td th:text="${#numbers.formatDecimal(value.firstNumber, 0, 'POINT', 1, 'POINT')}"></td>
    <td th:text="${#numbers.formatDecimal(value.secondNumber, 0, 'POINT', 1, 'POINT')}"></td>
</tr>

该方案完全符合你的需求：后端内存中的double值保留全部精度，仅在前端渲染时按1位小数格式化展示，不需要额外开发，也不存在Bean注册、扫描的各类问题。

方案2：修正自定义工具类的注册逻辑 #

如果坚持要自己实现格式化工具，按规范调整代码即可：

1. 把MathUtils从主启动类的静态内部类移出，单独建独立的类文件放在主启动类所在包或子包下，显式指定Bean名称：

// MathUtils.java 独立文件
import org.springframework.stereotype.Component;
import java.text.DecimalFormat;

// 显式指定Bean名称为mathUtils，和Thymeleaf中的引用名称完全匹配
@Component("mathUtils")
public class MathUtils {
    public String formatNumber(double number) {
        return new DecimalFormat("#.#").format(number);
    }
}

2. 不要在formatNumber方法上加任何@Bean注解，保持方法作为普通业务方法的定义即可。
3. 此时Thymeleaf中写@mathUtils.formatNumber(value.firstNumber)就能正常解析，不会再出现Bean找不到的错误。

踩坑提醒：不要把业务工具类嵌套写在主启动类里，这类写法很容易因为ComponentScan的扫描顺序、命名规则不匹配导致Bean注册异常，后续排查成本很高。

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