部署问题

本页面汇总部署相关常见问题。

Docker相关

Q: Docker启动失败怎么办？

A: 请检查以下几点：

1. 确认Docker服务已启动

systemctl status docker

2. 检查端口是否被占用

netstat -tlnp | grep 80
netstat -tlnp | grep 3306

3. 查看Docker日志

docker-compose logs

Q: 如何更新Docker镜像？

A: 执行以下命令：

docker-compose pull
docker-compose up -d

Q: 容器无法访问外网怎么办？

A: 检查Docker网络配置：

# 检查DNS配置
cat /etc/docker/daemon.json

# 添加DNS配置
{
  "dns": ["8.8.8.8", "114.114.114.114"]
}

# 重启Docker
systemctl restart docker

MySQL相关

Q: MySQL连接失败？

A: 请检查：

1. MySQL容器是否正常运行

docker ps | grep mysql

2. 检查连接配置

• 主机：使用容器名或IP
• 端口：3306
• 用户名/密码是否正确

3. 检查防火墙

firewall-cmd --list-ports

Q: 数据库初始化失败？

A:

1. 删除旧数据重新初始化

docker-compose down -v
docker-compose up -d

2. 手动导入SQL

docker exec -i mysql mysql -uroot -p123456 miseb_mer < /path/to/sql/miseb_mer.sql

Q: Flyway数据库迁移失败怎么办？

A: 我们提供了专门的Flyway修复工具来解决迁移失败问题。

症状：

• 应用启动报错 FlywayException
• 日志显示 Migration checksum mismatch
• 数据库迁移脚本执行失败

快速解决：

Linux/Mac系统：

cd deploy
./fix-flyway.sh

Windows系统：

cd deploy
fix-flyway.bat

工具功能：

1. 查看失败的迁移记录
2. 查看所有迁移历史
3. 删除失败的迁移记录
4. 删除指定版本的迁移记录
5. 重置Flyway历史表（危险操作）
6. 重启Admin服务触发迁移

详细说明：请参考 故障排查 - Flyway迁移失败

Redis相关

Q: Redis连接超时？

A: 检查Redis配置：

1. 确认Redis正在运行

docker exec -it redis redis-cli ping

2. 检查配置文件中的Redis地址

Nginx相关

Q: 访问返回502错误？

A: 后端服务未正常启动：

1. 检查Java服务状态

docker logs miseb-admin

2. 检查Nginx代理配置

Q: 静态资源404？

A:

1. 检查前端文件是否正确放置
2. 检查Nginx配置中的root路径

SSL证书

Q: 如何配置HTTPS？

A:

1. 申请SSL证书（阿里云/腾讯云/Let's Encrypt）

2. 修改Nginx配置

server {
    listen 443 ssl;
    server_name your-domain.com;

    ssl_certificate /path/to/cert.pem;
    ssl_certificate_key /path/to/key.pem;

    # ...其他配置
}

3. 重启Nginx

性能问题

Q: 系统响应慢？

A:

1. 检查服务器资源使用

top
free -h
df -h

2. 优化JVM参数

JAVA_OPTS="-Xms512m -Xmx1024m"

3. 开启Redis缓存

4. 配置CDN加速静态资源

下一步

• 功能问题 - 功能相关问题
• 开发问题 - 开发相关问题