Docker Compose中Logstash启动失败：配置错误排查求助

核心错误分析 #

错误提示Expected one of [ \t\r\n], "#", "input", "filter", "output" at line 1, column 1，说明Logstash解析配置文件时，第一行开头不是预期的合法字符，大概率是配置文件编码问题（比如带UTF-8 BOM头），或者Docker挂载时配置文件路径错误，导致Logstash读到了空文件或无效内容。

分步排查修复 #

1. 检查配置文件编码 #

• 用文本编辑器（比如VS Code、Notepad++）打开你的Logstash配置文件，确保编码是UTF-8无BOM格式。
• Windows环境编辑的文件容易带BOM头，直接另存为UTF-8（无BOM）即可解决。

2. 验证Docker Compose的配置挂载 #

确认docker-compose.yml中Logstash的pipeline配置挂载路径正确：

services:
  logstash:
    image: logstash:xxx # 替换为你的ELK对应版本
    volumes:
      # 确保本地配置文件路径存在且正确，容器内路径指向Logstash默认pipeline目录
      - ./logstash/pipeline.conf:/usr/share/logstash/pipeline/main.conf

如果本地路径错误或文件不存在，Logstash会加载默认空配置，直接触发语法错误。

3. 修正JDBC配置的两个关键细节 #

你的JDBC配置存在两个潜在问题，即使启动成功也会同步失败：

• MySQL 8.0驱动类错误：新版驱动类应为com.mysql.cj.jdbc.Driver，而非旧版的com.mysql.jdbc.Driver。
• Docker内MySQL地址错误：localhost在容器内指向自身，若MySQL在宿主机或其他Docker服务，需替换为：
  • 宿主机环境：用宿主机实际IP（如192.168.1.100）；
  • Docker服务：用MySQL的服务名（如mysql），前提是两者在同一Docker网络。

修正后的JDBC input配置：

input {
  jdbc {
    jdbc_driver_library => "/usr/share/logstash/pipeline/mysql-connector-java-8.0.27.jar"
    jdbc_driver_class => "com.mysql.cj.jdbc.Driver" # 修正驱动类
    # 替换为MySQL服务名/宿主机IP，添加时区参数避免时区报错
    jdbc_connection_string => "jdbc:mysql://mysql:3306/test?useSSL=false&serverTimezone=UTC"
    jdbc_user => "test"
    jdbc_password => "test"
    statement => "SELECT * from tests"
  }
}

4. 手动测试配置文件语法 #

进入Logstash容器，手动验证配置文件合法性：

docker exec -it <logstash-container-id> /usr/share/logstash/bin/logstash -f /usr/share/logstash/pipeline/main.conf --config.test_and_exit

若存在语法错误，会直接输出具体问题位置，快速定位修复。

验证步骤 #

1. 修正所有问题后，重启容器：docker compose down && docker compose up -d
2. 查看Logstash日志：docker logs -f <logstash-container-id>，确认无启动报错。

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