Troubleshooting
Flask
Error
Blank pages loading, but no errors.
Solution
Try a different port Sometimes the port is busy or used, but does not give a 'port in use' error
Poetry
Error
ModuleNotFoundError: No module named 'cachecontrol' when running poetry:
Solution
sudo apt install python3-cachecontrol
Supervisor
Error
supervisor.sock no such file
Solution
make sure directories and files for logs are created.
Error
BACKOFF can't find command... that is pointing to .venv
Solution
Prod: Check that the project is installed Dev: Check the symlink isn't broken
Error
Solution
Start and run supervisor with homebrew: brew services start supervisor
Error
Solution
The environment file has not been loaded. Most likely you need to run git secret reveal
This happens when the project has been cloned for the first time or directory has been deleted or the env files might have changed.
NGINX
Error
bind() to 0.0.0.0:80 failed (98: Address already in use)
Solution
sudo pkill -f nginx & wait $!
sudo systemctl start nginx
Error
DEV bind() to 127.0.0.1:80 failed (13: Permission denied)
Solution
NGINX is not running as root. It does not run reliably with homebrew.
Use sudo nginx -s reload instead of homebrew.
API Postgres
Error
[error] 94580#0: *18 kevent() reported that connect() failed (61: Connection refused) while connecting to upstream, client: 127.0.0.1, server: api.localhost, request: "GET / HTTP/1.1", upstream: "http://127.0.0.1:4200/", host: "api.macmini.local
Solution
DB cannot connect. Postgres string was built wrong, corrected by adding a test to check config is loaded properly.
Error
Local changes were working but nothing that connected to prod postgres.
api.ichrisbirch.com/tasks/ - 502 Bad Gateway
api.ichrisbirch.com Success redirect to /docs
ichrisbirch.com redirects to www in browser but error with requests
www.ichrisbirch.com/tasks/ - Internal Server Error
Can connect to prod server with DBeaver
Verified that the connection info is the same.
Seems that the API is not connecting to postgres instance
api.macmini.local WORKING api.macmini.local/ WORKING api.macmini.local/docs WORKING api.macmini.local/tasks WORKING api.macmini.local/tasks/1 WORKING api.macmini.local/tasks/completed
ichrisbirch.com WORKING api.ichrisbirch.com/ WORKING api.ichrisbirch.com/docs ERROR api.ichrisbirch.com/tasks ERROR api.ichrisbirch.com/tasks/1 ERROR api.ichrisbirch.com/tasks/completed
Solution
The issue was resolved by modifying the security group of the postgres instance to allow the ec2 instance to connect by allowing it's security group.
Pytest
Error
E assert 307 == 200 E + where 307 = <Response [307]>.status_code
Solution
The trailing / is missing from the endpoint being called in the test, resulting in a 307 Temporary Redirect
To fix:
/endpoint --> /endpoint/
Alembic
Error
Alembic is not able to upgrade to the latest because the revisions got out of sync.
Solution
Find the last revision that was successfully run (manually by inspecting the database) and then run:
alembic stamp <revision> to set the current revision to the last successful one.
Then run the upgrade again:
alembic upgrade head
FastAPI
Error
Request Error: Client error '405 Method Not Allowed' for url xxx
Solution
Make sure that the id is being passed correctly for routes like /endpoint/{id}/
The error will not say id is not found, it will give a 405 error because the url is not correct
Error
PATCH endpoint giving: 422 Unprocessable Entity: {"detail":[{"type":"missing","loc":["body","id"],"msg":"Field required"
Solution
PATCH endpoints require the ID in the endpoint, but also the ID must be passed in the payload for the model so it can update the record in the DB by ID.