Spring Boot Gradle项目Log4j控制台日志不显示问题求助

问题背景 #

我有一个Spring Boot Gradle项目，尝试配置日志切面以在控制台显示日志，但运行应用后日志并未出现。已遵循启用控制台日志的常规步骤，仍无法确定是日志配置错误还是遗漏了关键设置，需要排查问题并指导正确配置流程。

问题排查点及修复方案 #

1. Log4j2 配置文件格式错误 #

当前使用的配置文件沿用了Log4j 1.x的语法，但项目引入的是Log4j2，两者配置格式不兼容，导致日志无法被正确解析。

修复后的log4j2.properties配置（放在src/main/resources目录下）：

status = warn
name = PropertiesConfig

# 定义控制台输出Appender
appenders = console
appender.console.type = Console
appender.console.name = STDOUT
appender.console.layout.type = PatternLayout
appender.console.layout.pattern = %-5p %d{yyyy-MM-dd HH:mm:ss} %m%n

# 根日志配置
rootLogger.level = info
rootLogger.appenderRefs = stdout
rootLogger.appenderRef.stdout.ref = STDOUT

2. 切面切点范围覆盖不足 #

当前切点within(com.base.BaseDependencies.*)仅匹配com.base.BaseDependencies包下的直接类，无法覆盖子包（如controller、service等业务类所在的子包）。

修改切点表达式：

@Pointcut("within(com.base.BaseDependencies..*)")
public void generalPointCutLogger() {}

解释：..*表示匹配目标包及其所有子包下的类，确保切面能覆盖到所有业务逻辑类。

3. 确认AOP代理生效条件 #

• 确保LoggingAspect类被Spring容器扫描：当前切面所在包com.base.BaseDependencies.Aspects在主类@SpringBootApplication的默认扫描范围内，无需额外配置。
• 业务类/方法不能是final：Spring AOP基于动态代理实现，无法代理final类或final方法，需确保业务逻辑类和方法非final。

4. 依赖冲突检查 #

当前build.gradle中排除spring-boot-starter-logging并引入spring-boot-starter-log4j2的配置是正确的，但可通过以下命令验证依赖是否冲突：

./gradlew dependencies

检查输出中日志相关依赖，确保只有Log4j2系列依赖，无Logback或Log4j 1.x的冲突依赖。

验证步骤 #

1. 替换Log4j2配置文件为正确格式
2. 修改切面切点表达式为within(com.base.BaseDependencies..*)
3. 启动应用，调用任意业务接口或触发业务方法
4. 观察控制台是否输出切面日志，同时主类中的启动日志Apllication Started Successfully也应正常输出

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