微服务搭建踩坑

背景

最近要新搭建一个微服务项目，在搭建过程中踩了不少坑。为了防止再犯，这里把踩过的坑总结一下

微服务踩坑

泛型和Object

之前一直认为泛型和Object是差不多的，直到我搭建服务时碰到了ClassCastException异常，被折腾的很难受，这才仔细去了解两者的差异：

泛型提供了编译时类型检查，可以在编译时发现类型错误，而不是在运行时。这样可以有效避免运行时抛出异常ClassCastException。而Object所有的类型信息在运行时才会被检查，因此存在在运行时发生类型错误的风险。
泛型提高了代码的重用性和可读性。通过使用泛型，可以编写更加通用和类型安全的代码，而不像Object那样需要进行显式的类型转换。
泛型是一种参数化类型的编程范式，它允许在编写代码时指定类型参数，提供了更灵活和安全的方式来处理不同类型的数据。

依赖报错

我在搭建服务时有用到nacos，以下nacos依赖建议不要使用：

xml 复制代码

<dependency>
  <groupId>io.github.pig-mesh.nacos</groupId>
  <artifactId>nacos-config</artifactId>
  <version>3.0.0</version>
</dependency>

使用时会提示以下异常：

java 复制代码

Exception in thread "main" java.lang.IllegalStateException: java.lang.NoSuchMethodError: 'java.lang.Boolean org.springframework.core.SpringProperties.checkFlag(java.lang.String)'

建议尽量使用官方提供的依赖。

yml文件占位符

在yml文件里使用@占位符时，需要在pom.xml里进行以下配置：

xml 复制代码

    <build>
        <resources>
            <resource>
                <directory>src/main/resources</directory>
                <filtering>true</filtering>
            </resource>
        </resources>
        <plugins>
            <plugin>
                <artifactId>maven-resources-plugin</artifactId>
                <configuration>
                    <useDefaultDelimiters>false</useDefaultDelimiters>
                    <delimiters>
                        <delimiter>@</delimiter>
                    </delimiters>
                </configuration>
            </plugin>
        </plugins>
    </build>

如果yml占位符的值是从pom的父文件里获取的，也可以把该配置写在父pom.xml里

大型项目依赖管理

如果是一个大型项目，建议把项目的核心框架版本（Spring Boot、Spring Cloud等）、构建配置和环境管理放在根pom.xml里，把其他依赖的版本管理放在独立的子模块bom里。这样做有如下好处：

职责分离。分离职责后使每个配置文件职责清晰，便于维护
大型微服务项目包含大量内部模块，而每个模块又包含多个子模块，通过独立模块集中管理内部模块依赖，可确保版本一致性，避免循环依赖。
新增或调整内部模块依赖时，只需修改BOM模块，不影响根POM

nacos命名空间

你可能会碰到这样的问题：日志明明已经显示服务实例已成功注册，但是在nacos控制台却没有查询到该服务的信息。这种情况可能是nacos的namespace配置有问题，需要进行以下排查：

查询namespace的值是否为命名空间的id。namespace填写的是命名空间id，而不是命名空间的名称。
如果是id，排查id填写是否有误

gateway路由配置

gateway路由配置的uri必须有http://或https://请求头。此外，gateway的predicates不能为空