best_practice/maxwell.md

@@ -665,6 +665,19 @@ bootstrap-start -> bootstrap-insert -> bootstrap-complete  #其中，start和com
 导出JMX信息，需要预先设置JAVA_OPTS
 ```
 
+## 常见错误解决
+```sql
+1. ERROR Maxwell - Maxwell couldn't find the requested binlog, exiting...
+原因：一般出现在关闭maxwell一段时间后启动maxwell时，由于记录的binlog文件已被自动删除；有时当很大批量的binlog日志写入时maxwell会缓存下来处理不过来的binlog至文件系统，而当其处理完文件系统的缓存后由于binlog存储空间不足记录的原始位置的binlog文件已被删除，也会出现这个错误
+处理方法：调整binlog的存储空间和删除模式，手动修改maxwell的元数据库中的positions表中对应client_id的binlog_file和binlog_position的值
+update maxwell.positions set binlog_file = 'mysql-bin.005302',binlog_position = 0 where client_id = 'bdp-rds-003.mysql.rds.aliyuncs.com';
+
+2. java.lang.RuntimeException: Couldn't find database mysql
+原因：账户没有mysql库的访问权限，上游修改了mysql库的user表
+处理方法：最优方法是给maxwell使用的用户对应的权限；临时的方法是在maxwell的元数据库中的tables表中插入对应user表的信息，注意对应的database_id
+INSERT INTO maxwell.tables (id, schema_id, database_id, name, charset, pk) VALUES (727, 1092, 54, 'user', 'utf8', 'Host,User');
+```
+
 ## 附：完整参数
 
 | 参数                                                         | 值类型                 | 描述                                                         | 默认值            |