Tomcat运行时为何不输出catalina.out日志文件？

Question

在Tomcat运行时，有时会遇到不输出`catalina.out`日志文件的问题。常见的原因包括：1) Tomcat配置文件`logging.properties`中日志级别设置过高，导致部分日志未被记录；2) `catalina.sh`或`catalina.bat`启动脚本被修改，未正确重定向标准输出到`catalina.out`；3) 文件系统权限不足，Tomcat进程无法写入日志文件；4) 日志滚动策略配置错误，导致日志文件丢失或覆盖；5) Tomcat以Windows服务方式运行时，日志输出可能依赖于`log4j`或其他日志框架，而非默认的`catalina.out`。解决此问题需检查启动脚本、日志配置文件及权限设置，确保日志输出路径和方式正确无误。

Answer 1

1. 问题概述

在Tomcat运行时，有时会遇到不输出`catalina.out`日志文件的问题。这不仅会影响问题排查的效率，还可能导致关键信息丢失。以下是常见的原因：

• 日志级别设置过高。
• 启动脚本未正确重定向标准输出。
• 文件系统权限不足。
• 日志滚动策略配置错误。
• 依赖其他日志框架而非默认的日志机制。

为了解决这些问题，我们需要从多个角度进行分析和验证。

2. 原因分析与排查步骤

以下是针对上述问题的详细分析和解决方法：

1. 日志级别设置过高: 检查`logging.properties`文件中的日志级别是否设置得过于严格（如`INFO`或`WARNING`），导致部分日志未被记录。可以尝试将日志级别调整为`FINE`或`ALL`以捕获更多细节。
2. 启动脚本问题: 确认`catalina.sh`或`catalina.bat`中是否正确设置了日志重定向。例如，以下代码片段展示了如何确保标准输出被写入到`catalina.out`：

# catalina.sh
exec >> "$CATALINA_BASE/logs/catalina.out" 2>&1

如果脚本被修改，请恢复默认配置并重新测试。

2.1 文件系统权限不足

检查Tomcat进程是否有足够的权限写入日志文件所在的目录。可以通过以下命令验证：

ls -l $CATALINA_BASE/logs

如果发现权限不足，可以使用`chmod`或`chown`命令调整权限，例如：

chmod 755 $CATALINA_BASE/logs
chown tomcat:tomcat $CATALINA_BASE/logs

2.2 日志滚动策略配置错误

日志滚动策略通常由`log4j`或`LogManager`控制。如果配置错误，可能会导致日志文件丢失或覆盖。以下是`logging.properties`中正确的日志滚动策略示例：

java.util.logging.FileHandler.pattern = %h/logs/tomcat.%g.log
java.util.logging.FileHandler.limit = 5000000
java.util.logging.FileHandler.count = 10
java.util.logging.FileHandler.append = true

确保`pattern`、`limit`、`count`等参数配置合理。

3. Windows服务模式下的特殊处理

当Tomcat以Windows服务方式运行时，日志输出可能依赖于`log4j`或其他日志框架。此时需要检查以下内容：

检查项	解决方案
`log4j.properties`或`log4j.xml`配置	确保日志路径和格式正确，并启用调试模式以验证配置。
服务启动参数	确认启动参数中是否包含日志相关的配置，例如`-Djava.util.logging.config.file`。

4. 流程图：问题排查步骤

以下是问题排查的整体流程图：

graph TD;
            A[开始] --> B{日志级别是否过高};
            B --是--> C[调整日志级别];
            B --否--> D{启动脚本是否正确};
            D --是--> E[检查权限];
            D --否--> F[修复脚本];
            E --权限不足--> G[调整权限];
            E --权限正常--> H{日志滚动策略是否正确};
            H --是--> I[检查配置];
            H --否--> J[结束];