Skip to content

Commit 6a1b3b1

Browse files
committed
Improve troubleshooting section in README
1 parent 3ae174a commit 6a1b3b1

File tree

1 file changed

+56
-0
lines changed

1 file changed

+56
-0
lines changed

README.md

Lines changed: 56 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -78,3 +78,59 @@ Translations
7878
* [Turkish](https://github.com/sqlmapproject/sqlmap/blob/master/doc/translations/README-tr-TR.md)
7979
* [Ukrainian](https://github.com/sqlmapproject/sqlmap/blob/master/doc/translations/README-uk-UA.md)
8080
* [Vietnamese](https://github.com/sqlmapproject/sqlmap/blob/master/doc/translations/README-vi-VN.md)
81+
82+
## Troubleshooting
83+
84+
This section helps users resolve common issues encountered while using sqlmap.
85+
86+
---
87+
88+
### Missing mandatory option error
89+
If you run sqlmap without specifying a target, you may see:
90+
missing a mandatory option (-u, -d, -l, -m, -r, -g, -c, etc.)
91+
92+
Solution:
93+
Always specify a valid target URL:
94+
95+
python sqlmap.py -u "http://example.com/page.php?id=1"
96+
97+
---
98+
99+
### Connection problems
100+
If sqlmap cannot connect to the target URL:
101+
- Ensure the website is reachable in a browser
102+
- Try using a different User-Agent:
103+
--random-agent
104+
- Check your internet connection or firewall restrictions
105+
106+
---
107+
108+
### Injection not detected (false negative)
109+
If sqlmap does not detect SQL injection:
110+
- Increase testing intensity:
111+
--level=5 --risk=3
112+
113+
- Try all techniques:
114+
115+
--technique=BEUSTQ
116+
117+
- Test specific parameter manually using `-p`
118+
119+
---
120+
121+
### WAF / Firewall blocking requests
122+
Some websites may block sqlmap requests.
123+
124+
Possible solutions:
125+
- Use random User-Agent:
126+
--random-agent
127+
- Add delay between requests:
128+
--delay=2
129+
- Use tamper scripts to bypass filtering:
130+
--tamper=space2comment
131+
---
132+
### General tip
133+
For better results, always ensure:
134+
- Target is reachable
135+
- Correct parameter is provided
136+
- Proper technique selection is used

0 commit comments

Comments
 (0)